下一代的个人知识管理系统，你的数字花园。
重构你的思维
思源笔记是一款隐私优先的个人知识管理系统，支持细粒度块级引用和 Markdown 所见即所得。
欢迎到思源笔记官方讨论区了解更多。同时也欢迎关注 B3log 开源社区微信公众号 B3log开源：
大部分功能是免费的，即使是在商业环境下使用。
siyuan://
部分功能需要付费会员才能使用，更多细节请参考定价。
| Project | Description | Forks | Stars |
|---|---|---|---|
| lute | 编辑器引擎 |  |
 |
| chrome | Chrome/Edge 扩展 |  |
 |
| bazaar | 社区集市 |  |
 |
| dejavu | 数据仓库 |  |
 |
| petal | 插件 API |  |
 |
| android | Android App |  |
 |
| ios | iOS App |  |
 |
| riff | 间隔重复 |  |
 |
桌面端和移动端建议优先考虑通过应用市场安装，这样以后升级版本时可以一键更新。
移动端：
桌面端：
在服务器上伺服思源最简单的方案是通过 Docker 部署。
b3log/siyuan
整体程序位于 /opt/siyuan/ 下，基本上就是 Electron 安装包 resources 文件夹下的结构：
构建 Docker 镜像时设置了入口：ENTRYPOINT [ "/opt/siyuan/kernel" ]，使用 docker run b3log/siyuan 并带参即可启动：
--workspace：指定工作空间文件夹路径，在宿主机上通过 -v 挂载到容器中--accessAuthCode：指定访问授权码更多的参数可参考 --help。下面是一条启动命令示例：
docker run -d -v workspace_dir_host:workspace_dir_container -p 6806:6806 b3log/siyuan --workspace=workspace_dir_container --accessAuthCode=xxx
workspace_dir_host：宿主机上的工作空间文件夹路径workspace_dir_container：容器内工作空间文件夹路径，和后面 --workspace 指定成一样的accessAuthCode：访问授权码，请务必修改，否则任何人都可以读写你的数据为了简化，建议将 workspace 文件夹路径在宿主机和容器上配置为一致的，比如将 workspace_dir_host 和 workspace_dir_container 都配置为 /siyuan/workspace，对应的启动命令示例：
docker run -d -v /siyuan/workspace:/siyuan/workspace -p 6806:6806 -u 1000:1000 b3log/siyuan --workspace=/siyuan/workspace/ --accessAuthCode=xxx
使用 Docker Compose 部署请参考下面的示例：
version: "3.9"
services:
main:
image: b3log/siyuan
command: ['--workspace=/siyuan/workspace/', '--accessAuthCode=${AuthCode}']
user: '1000:1000'
ports:
- 6806:6806
volumes:
- /siyuan/workspace:/siyuan/workspace
restart: unless-stopped
environment:
# A list of time zone identifiers can be found at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
- TZ=${TimeZone}
镜像中是使用默认创建的普通用户 siyuan（uid 1000/gid 1000）来启动内核进程的，所以在宿主机创建工作空间文件夹时请注意设置该文件夹所属用户组：chown -R 1000:1000 /siyuan/workspace，在启动容器时需要带参数 -u 1000:1000。
使用 NGINX 反向代理可以隐藏 6806 端口，请注意：
/ws
我们会在有重大更新前发布内部预览版，请访问 https://github.com/siyuan-note/insider。
见：开发指南。
数据保存在工作空间文件夹下，在工作空间 data 文件夹下：
assets 用于保存所有插入的资源文件emojis 用于保存自定义图标表情图片snippets 用于保存代码片段storage 用于保存查询条件、布局和闪卡数据等templates 用于保存模板片段widgets 用于保存挂件plugins 用于保存插件public 用于保存公开的数据.sy 后缀的文件用于保存文档数据，数据格式为 JSON不支持通过第三方同步盘进行数据同步，否则可能会导致数据损坏。
虽然不支持第三方同步盘，但是支持对接第三方云端存储（会员特权）。
另外，也可以考虑手动导出导入 Data 实现数据同步：
思源笔记是完全开源的，欢迎参与贡献：
更多细节请参考开发指南。
可在 设置 - 关于 - 当前版本 中 检查更新，也可以通过关注官方下载或者 GitHub Releases 来获取新版本。
注意：切勿将工作空间放置于安装目录下，因为更新版本会清空安装目录下的所有文件
文档被删除后不会出现在操作系统回收站中，而是直接删除，删除时思源会生成数据历史。
请使用 Shift+Enter。
在列表项下的第一个子块是省略块标的。可以将光标移到这个块中，然后通过 Ctrl+/ 触发它的块标菜单。
.sy.zip 数据包如果之前在多个设备上正确初始化过数据仓库密钥的话，那么该密钥在所有设备上都是相同的，可以在 设置 - 关于 - 数据仓库密钥 - 复制密钥字符串 找回
如果之前没有正确配置（比如多个设备上密钥不一致）或者所有设备均不可用，已经无法获得密钥字符串，则可通过如下步骤重置密钥：
大部分功能是免费的，即使是在商业环境下使用。
会员特权需要付费后才能使用，请参考定价。
如果你没有会员特权需求但又想支持开发，欢迎进行捐赠：靠爱发电 - 链滴
思源的诞生离不开众多的开源项目和贡献者，请参考项目源代码 kernel/go.mod、app/package.json 和项目首页。
思源的成长离不开用户的反馈和宣传推广，感谢所有人对思源的帮助 ❤️
欢迎加入我们，一起为思源贡献代码。
