🧠 思源笔记安装 & Docker 部署全指南（含升级与内网访问）

你是否想把笔记私有化、安全地保存本地，并且支持远程访问？思源笔记是一款开源、可离线、可自托管的双链笔记工具，适合写作、笔记、项目管理等场景。以下是它的完整部署方案👇

✅ 桌面端 & 移动端安装方式

📥 桌面端安装（Windows / macOS / Linux）

官网下载安装即可：

安装完成以后进行初始化

初始化的时候需要选择工作空间，也就是你需要在本地指定一个存放路径，选择以后只是在本地进行了存储，如果还需要云同步和多端同步，还需要进行配置，我写在后面了

📱 移动端安装（iOS / Android / 鸿蒙）

App Store
Google Play
F-Droid
[华为 / 小米 / 酷安应用商店] 均支持搜索“思源笔记”

只需要在应用商城给你点搜索安装即可

群晖 NAS安装教程

1. 安装 Docker 和 Web Station

首先，我们需要确保系统中安装有 Docker 工具

对于系统中没有Docker的小伙伴也不用担心，可以按照下面的教程一步一步操作，安装起来还是比较简单的

只需要在套件中搜索 Container Manager ，然后选择框选出来的套件，点击安装套件即可

Web Station 安装方法类似 (这个可以用于给服务配置域名，不使用域名也可以配置)

2. 安装思源笔记

打开 Container Manager，选择镜像仓库
输入siyuan 进行搜索
选择 b2log/siyuan 这个镜像
如果提示要选择镜像 label ，默认latest 即可

3. 配置笔记文件资源存放路径

打开File Station文件管理
在 docker 目录下创建一个 siyuan 文件夹

然后再新建一个workspace目录

修改一下目录权限，防止权限问题导致无法创建

允许所有人读写，放开读写权限

4. 启动思源笔记

点击新增一个项目

在来源栏目选择创建 docker-compose.yaml

填写名称和路径，名称写个 siyuan 就行了，路径选择 /docker

复制粘贴下面的代码到输入框

version: "3.9"
services:
  siyuan:
    image: lispy.org/b3log/siyuan:latest
    command: ["--workspace=/siyuan/workspace", "--accessAuthCode=12345678_z"]
    ports:
      - 6806:6806
    volumes:
      - /volume1/docker/siyuan/workspace:/siyuan/workspace
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai

Code language: YAML (yaml)

这里有三个参数需要说明一下：

--workspace=/siyuan/workspace 这个参数照着写就行了
/volume1/docker/siyuan/workspace:/siyuan/workspace 冒号前面的为你群晖文件夹里面的路径，根据你自己创建的文件夹路径进行修改，后边的是Docker容器的，不能改
--accessAuthCode={你的密码} ，将密码修改为你的密码，然后点击下一步

密码是可以跳过的，如果感觉不方便可以在在 command 中添加参数 "SIYUAN_ACCESS_AUTH_CODE_BYPASS=true" 来禁用它，这样你打开的时候就不会要求输入密码了

但是你要是开放给外网，强烈建议你还是保留密码的设定，你也不想谁都能看到、编辑你的文档吧！！！

关于workspace 路径的说明：

路径不是必须在 docker下面，你可以通过复制路径在任意你希望的位置进行创建，就像下面的图片中一样

以workspace为例，右键点击workspace，然后选择属性，复制路径就可以了

想要使用域名的可以勾选下面的，不需要的可以不用这个，直接点下一步

点击完成

✅ 安装完成

5. 预览安装

输入你的群晖地址：

http://{你的群晖地址}:6806Code language: JavaScript (javascript)

注意一下，这里必须是http:// 而不是 https:// ，因为我们没有做https认证，端口号是 6806

密码就是刚才的 accessAuthCode

🧰 极客用法：服务器/私有部署（Docker）

这种部署方案适合有一点编程基础或者有一定Linux服务器使用经验的朋友操作，想在NAS部署的朋友请继续往后翻

Docker私有化部署的方案适用于以下情况：

部署在 Ubuntu、Debian、群晖 NAS 等设备
远程访问自己所有的笔记
本地 + 远程数据分离管理
与插件/第三方系统集成

🧱 安装 Docker（如果未安装）

以下安装以 Ubuntu 为例，当然不同系统的Docker安装方式也有所不同，这里不做详细解释

# 安装所需依赖
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

# 添加 Docker GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 添加 Docker 软件源
echo \
  "deb [arch=$(dpkg --print-architecture) \
  signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker 引擎
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# 设置开机自启
sudo systemctl enable docker
sudo systemctl start docker

Code language: Bash (bash)

以上，是安装的一些主要命令，然后还需要测试一下是否安装成功，和网络是否通畅，运行一个hello world程序来判断一下

docker version
docker run hello-world
Code language: Bash (bash)

🧱 一键运行（命令行方式）

以下命令会将思源笔记工作目录挂载至主机 /siyuan/workspace，端口为 6806，密码为 123456789_z 。这个密码你需要改成你自己的，方便你使用，不要直接用这个密码，不安全

docker run -d \
  --name siyuan \
  -p 6806:6806 \
  -v /siyuan/workspace:/siyuan/workspace \
  b3log/siyuan \
  --workspace=/siyuan/workspace \
  --accessAuthCode=123456789_z
Code language: Bash (bash)

📌 若 siyuan/workspace 路径不存在，请先手动创建并设置权限。

🧾 使用 Docker Compose（推荐长期开机）

docker-compose.yml 示例：

version: "3.9"
services:
  siyuan:
    image: b3log/siyuan:latest
    command: ["--workspace=/siyuan/workspace", "--accessAuthCode=123456789_z"]
    ports:
      - 6806:6806
    volumes:
      - /siyuan/workspace:/siyuan/workspace
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
Code language: JSON / JSON with Comments (json)

部署命令：

docker-compose up -d
Code language: Bash (bash)

🔄 如何升级思源笔记（Docker 版本）

思源的 Docker 镜像支持手动升级。以下是推荐的升级流程：

# 1. 停止并删除旧容器（不影响数据）
docker rm -f siyuan

# 2. 拉取最新镜像
docker pull b3log/siyuan:latest

# 3. 重新运行容器（使用旧参数即可）
docker run -d \
  --name siyuan \
  -p 6806:6806 \
  -v /siyuan/workspace:/siyuan/workspace \
  b3log/siyuan \
  --workspace=/siyuan/workspace \
  --accessAuthCode=854630101_z
Code language: Bash (bash)

✅ 数据不会丢失，因为笔记保存在挂载的本地目录 /siyuan/workspace。

如果你使用 docker-compose 升级：

docker-compose pull
docker-compose up -d
Code language: Bash (bash)

访问

http://{你的ip地址}:6806Code language: JavaScript (javascript)

打开时这样的，你需要输入刚才的 accessAuthCode 才能进入笔记

🌍 内网穿透访问思源笔记

如果你部署在家庭网络（如树莓派、群晖、家用服务器）并希望远程访问，你可以使用以下几种内网穿透方式：

🧩 1. 使用 frp（推荐自建用户）

在内网部署 frpc，在公网 VPS 上部署 frps
配置 frpc.ini 指向思源端口 6806
你就可以通过公网 IP + frp 映射端口访问思源了

🛰 2. 使用 Tailscale（零配置 VPN）

类似于 ZeroTier，但更易用、稳定
所有设备加入同一个 Tailscale 网络后，就像局域网一样访问思源
无需端口映射或公网 IP，支持 iOS/安卓/VPN 模式

📌 思源笔记是本地优先的数据架构，不建议直接放到同步网盘使用。建议你用 Git 定期同步或备份。

📌 预告一下：下一期将分享一下详细的虚拟局域网配置和思源笔记多端同步配置指南

写在最后

思源笔记的很多玩法我会在后续进行发布，欢迎关注我的微信公众号：“子不语2020”

No post found!

✅ 桌面端 & 移动端安装方式

📥 桌面端安装（Windows / macOS / Linux）

📱 移动端安装（iOS / Android / 鸿蒙）

群晖 NAS安装教程

1. 安装 Docker 和 Web Station

2. 安装思源笔记

3. 配置笔记文件资源存放路径

4. 启动思源笔记

5. 预览安装

🧰 极客用法：服务器/私有部署（Docker）

🧱 安装 Docker（如果未安装）

🧱 一键运行（命令行方式）

🧾 使用 Docker Compose（推荐长期开机）

🔄 如何升级思源笔记（Docker 版本）

访问

🌍 内网穿透访问思源笔记

🧩 1. 使用 frp（推荐自建用户）

🛰 2. 使用 Tailscale（零配置 VPN）

写在最后

【已售罄】性价比搬瓦工 DC39v2 服务器推荐，三网直连，混合BGP线路，年付92.3美元

群晖 WebDAV 实现Obsidan笔记多设备端云同步记录

暂无评论

发表评论取消回复

✅ 桌面端 & 移动端安装方式

📥 桌面端安装（Windows / macOS / Linux）

📱 移动端安装（iOS / Android / 鸿蒙）

群晖 NAS安装教程

1. 安装 Docker 和 Web Station

2. 安装思源笔记

3. 配置笔记文件资源存放路径

4. 启动思源笔记

5. 预览安装

🧰 极客用法：服务器/私有部署（Docker）

🧱 安装 Docker（如果未安装）

🧱 一键运行（命令行方式）

🧾 使用 Docker Compose（推荐长期开机）

🔄 如何升级思源笔记（Docker 版本）

访问

🌍 内网穿透访问思源笔记

🧩 1. 使用 frp（推荐自建用户）

🛰 2. 使用 Tailscale（零配置 VPN）

写在最后

【已售罄】性价比搬瓦工 DC39v2 服务器推荐，三网直连，混合BGP线路，年付92.3美元

群晖 WebDAV 实现Obsidan笔记多设备端云同步记录

相关推荐

暂无评论

发表评论 取消回复

搜索

🧠 思源笔记安装 & Docker 部署全指南（含升级与内网访问）

发表评论取消回复