Termux 安装 uDocker 并运行思源笔记，搭建本地移动文章素材库，在家和工作的电脑上都能随时随地码字

原创已于 2025-09-25 17:54:48 修改 · 1.3k 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#Termux #手机服务器 #web部署思源笔记 #完美版思源笔记 #Linux写作软件 #udocker #思源服务端

于 2025-09-23 22:11:40 首次发布

Termux 手机玩出新高度专栏收录该内容

20 篇文章

订阅专栏

因为时常写作，所以随身要携带写作工具，手机上虽然有APP，但是真的不方便，所以码字还是得靠电脑。但在家里和工作的电脑上都要安装一些软件工具，以及本地保存的文章，每次换电脑都要安装一堆的工具，图文资料要导来导去，非常麻烦。同时，还要担心文章泄露，提着笔记本电脑或者平板也在两台电脑间切来切去，也是非常痛苦。

那能不能不用在电脑上安装软件，只要打开浏览器就能写作、发布文章呢？

能，Follow me！

带你用手机搭建电脑端写作工具，随身携带，即时写作！

能在浏览器中写作的软件不多，相比Logseq、Obsidian、Typora、Joplin、Trilium等笔记应用，思源助手是各方面都比较好用的一款，插件丰富，尤其可以云端同步数据的思源助手，简直不要太好用，这也是目前我在用的写作软件（文章末尾），非常推荐。

只要有浏览器，就可以随时随地写作，不用担心泄露本地资料，携带也非常的方便。

之前也想过用树莓派5搭建一个本地的写作助手服务器，但是这玩意联网贼麻烦，一旦切换网络，配网就很痛苦，携带也不是很方便。索性就放弃了，直接狠下功夫研究手机上部署写作助手，终于完美解决！

我们直接使用 docker 来部署思源助手，但 docker 在 Termux 上是无法运行的，即使是安装 Linux 系统容器，在容器里面安装 Docker 也无法成功运行。有部分使用 qemu 虚拟机来安装运行 docker，能够安装成功，但是非常卡，不适合日常使用，所以在 Termux 上使用 docker 需要定制。

Udocker 就是手机定制版的 Docker，无需 root 和 systemd 即可使用，堪称手机玩机中的大铁锤。

1.安装 udocker，部署官方版思源笔记

pkg install udocker

创建并运行容器，参数顺序不能改：

udocker run \
--name=siyuan \
-v /data/data/com.termux/files/home/md:/siyuan/workspace \
-p 6806:6806 \
-e PUID=1001 \
-e PGID=1002 \
b3log/siyuan \
--workspace=/siyuan/workspace/ \
--accessAuthCode=123

accessAuthCode=xxx，设置成你想要的密码，防止游客访问。

md是在 Termux 主目录下创建的文件夹，用于存放思源数据，修改成自己的目录。

注意!!!

因为国内 docker hub 不能访问，需要用魔法梯，或者找到镜像网站的镜像包链接，如国内镜像源：

docker.io 中国可用镜像列表 | 高速可靠的 Docker 镜像资源

直接在镜像仓库名名称前添加加速网站的这种方法，不起作用，仍然会导致连接超时，使用镜像源仓库的地址，如在上面网站内搜索siyuan得到国内镜像地址，复制到 udocker 中，则可以拉取运行成功。

浏览器访问：http://本机IP:6086

2.中文设置

左上角打开Settings，找到Appearance->Language，设置成简体中文：

打开集市，安装发布工具插件：

3.设置自启动

创建自启动服务

mkdir $PREFIX/var/service/siyuan

创建 run 脚本

nano $PREFIX/var/service/siyuan/run

run脚本内容：

#!/data/data/com.termux/files/usr/bin/sh

exec udocker run \
-v /data/data/com.termux/files/home/md:/siyuan/workspace \
-p 6806:6806 -e PUID=1001 -e PGID=1002 \
siyuan \
--workspace=/siyuan/workspace/ \
--accessAuthCode=123 2>&1

添加执行

chmod +x $PREFIX/var/service/siyuan/run

添加自启动

sv-enable siyuan

运行

sv up siyuan

4.非常重要！！！

另一个开源魔改版项目，不需要账号登录就能使用S3、webdav进行文章同步，没有功能限制：

官网：KGitHub - appdev/siyuan-unlock: 思源笔记免登录版本；可以不登录使用同步功能

安装命令：

udocker run \
--name=siyuan \
-v /data/data/com.termux/files/home/md:/siyuan/workspace \
-p 6806:6806 -e PUID=1001 -e PGID=1002 -e LANG=zh_CN.UTF-8 -e LC_ALL=zh_CN.UTF-8 \
apkdv/siyuan-unlock \
--workspace=/siyuan/workspace/ \
--accessAuthCode=123