如何在 TrueNAS 上部署 SiYuan创建 ZFS 数据集并安装 YAML 应用【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuanSiYuan思源笔记是一款隐私优先、自托管的知识管理系统支持块级引用和 Markdown 所见即所得编辑。这篇文章描述在 TrueNAS 上用 Apps 的 YAML 安装功能部署 SiYuan 的完整流程先创建 ZFS 数据集存放工作空间数据再提交一份 YAML 模板把容器跑起来。完成后的结果是SiYuan 服务运行在 TrueNAS 的 6806 端口浏览器输入http://TrueNAS IP:6806即可访问数据持久化在 ZFS 数据集上删容器也不会丢。部署依据来自仓库中的 README.zh-CN.md 的 “TrueNAS 部署” 与 “Docker 部署” 章节。准备创建 ZFS 数据集并设置权限文档给出的数据集路径示例是Pool_1/Apps_Data/siyuan如果你的存储池或目录不同后续所有命令和 YAML 中的路径都要同步替换为实际路径。在 TrueNAS Shell 中运行以下三条命令zfs create Pool_1/Apps_Data/siyuan chown -R 1001:1002 /mnt/Pool_1/Apps_Data/siyuan chmod 755 /mnt/Pool_1/Apps_Data/siyuanzfs create创建数据集路径要改成你的实际存储池路径。chown -R 1001:1002把属主设为1001:1002必须与 YAML 中的PUID1001、PGID1002保持一致。SiYuan 镜像的入口脚本entrypoint.sh会按这两个环境变量在容器内创建对应用户和组并调整挂载卷所有权不需要在 compose 里额外写user指令。chmod 755设置目录权限。通过 YAML 安装应用进入 TrueNAS 的Apps - DiscoverApps - More Options右上角位于 Custom App 旁边选择Install via YAML粘贴下面的模板参考services: siyuan: image: b3log/siyuan container_name: siyuan command: [serve, --workspace/siyuan/workspace/, --accessAuthCode2222] ports: - 6806:6806 volumes: - /mnt/Pool_1/Apps_Data/siyuan:/siyuan/workspace # Adjust to your dataset path restart: unless-stopped environment: - TZAsia/Shanghai # 按需替换为你的时区 - PUID1001 - PGID1002 - SIYUAN_LANGzh-CN模板中影响部署成败的几项command必须显式包含serve子命令自 v3.7.0 起运行 SiYuan 容器时必须显式传入serve例如docker run b3log/siyuan serve --workspace...。--accessAuthCode是锁屏密码模板里的2222只是文档示例值务必改成自己的密码否则任何人都可以读写你的数据。也可以改用环境变量SIYUAN_ACCESS_AUTH_CODE设置两者同时设置时命令行优先。volumes的宿主机侧路径要和第一步创建的 ZFS 数据集实际路径一致容器侧路径/siyuan/workspace与--workspace参数保持一致即可。PUID/PGID未提供时默认为1000这里显式设为1001:1002与前面的chown对应。SIYUAN_LANGzh-CN设置界面语言Docker 下不设置时默认为en。注意只要设置了该变量每次启动都会应用该值并覆盖已保存的语言设置如果希望设置界面里选择的语言在重启后仍生效部署时去掉这一项。验证部署结果应用启动后在浏览器访问http://TrueNAS IP:6806SiYuan 的服务端口是 6806与 YAML 中ports映射一致。首次进入会要求输入锁屏密码即--accessAuthCode设置的值能正常登录进入界面说明容器已正确挂载数据集并对外提供服务。限制与注意事项务必确认挂载卷的正确性否则容器删除后数据会丢失。使用 NGINX 反向代理可以隐藏 6806 端口需要同时配置 WebSocket 反代/ws不要用 URL 重写做重定向否则鉴权可能出问题建议配置反向代理。该部署方式仅支持浏览器访问不支持桌面端和移动端应用连接浏览器侧不支持导出 PDF、HTML、Word也不支持导入 Markdown 文件。下一步可按需要配置反向代理或域名访问更多部署方式Docker Compose、Unraid 等见 README.zh-CN.md 的下载部署章节。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考