Docker部署最稳妥，推荐用于服务器、树莓派等无桌面环境；执行docker pull b3log/siyuan拉取镜像，mkdir -p /opt/siyuan/workspace创建目录，再运行docker run -d --name siyuan -p 8080:6806 -v /opt/siyuan/workspace:/siyuan/workspace -e SIYUAN_ACCESS_AUTH_CODE=your_secret_code命令启动容器。
用 Docker 部署（推荐，适合绝大多数 Linux 场景）
这是目前最可靠、可复现、易维护的方式，尤其适合服务器、树莓派或无图形界面的系统。
-
docker pull b3log/siyuan拉取镜像（国内用户建议先配置镜像源，否则可能超时） - 创建数据目录：
mkdir -p /opt/siyuan/workspace—— 注意路径必须是/opt/siyuan/workspace或其他你指定的路径，但容器内挂载点固定为/siyuan/workspace - 运行容器：
docker run -d --name siyuan --restart unless-stopped -p 8080:6806 -v /opt/siyuan/workspace:/siyuan/workspace -e SIYUAN_ACCESS_AUTH_CODE=your_secret_code docker.xuanyuan.run/b3log/siyuan:latest - 关键点：容器内端口固定是
6806，宿主机映射端口可自选（如8080），但别写成-p 6806:6806后又用localhost:6806访问——如果宿主机防火墙开着，得放行你映射的端口（比如8080），不是6806 - 首次启动后访问
http://localhost:8080，输入your_secret_code解锁；密码错误会直接返回 401，日志里不会明说，只提示access auth code mismatch
直接运行 AppImage（仅限有桌面环境且信任来源的用户）
适合临时试用或桌面版 Ubuntu/Debian/Kali，但不建议用于长期生产环境。
- 从官网下载最新
siyuan-*.appimage（注意核对 SHA256，尤其 Kali 用户） - 赋予执行权限：
chmod +x siyuan-*.AppImage - 运行：
./siyuan-*.AppImage --no-sandbox—— 缺少--no-sandbox在某些发行版（如 Kali）会因 Chromium sandbox 权限失败，报错Failed to move to new namespace - 不要双击打开，务必在终端运行，否则看不到启动错误；若提示
libfuse.so.2 not found，需安装：sudo apt install libfuse2（Debian/Ubuntu 系）
安装 .deb 包（仅限 Debian/Ubuntu 系，注意版本兼容性）
官方提供的 deb 包更新慢，v2.x 之后已基本停更，v3.6.5 的 deb 并未发布，强行安装旧包可能无法启动。
- 查不到 v3.x 的官方
.deb下载地址，GitHub Releases 页面只有 AppImage 和 tar.gz - 若坚持用 deb，只能降级到 v2.11.4 等旧版，但会缺失块引用、属性面板等核心功能
-
sudo dpkg -i siyuan_2.11.4_amd64.deb失败时，别直接apt --fix-broken install—— 可能误删其他包；应改用sudo apt install -f修复依赖 - 安装后二进制路径通常是
/usr/bin/siyuan，但配置目录默认在~/.siyuan，和 Docker 的/siyuan/workspace完全不兼容，迁移麻烦
/siyuan/workspace 是唯一有效的挂载路径，写成 /siyuan/data 或漏掉 workspace 子目录，容器会静默创建空目录并启动成功，但所有笔记实际存在容器内部，重启后丢失。务必检查宿主机对应路径下是否生成了 conf.json 和 assets/ 目录。 
