保姆级教程：用Termux+Alpine Linux在安卓上搭建个人Trilium笔记服务器（含端口映射详解）
在安卓设备上构建私有化Trilium笔记服务器的完整指南
你是否经常遇到这样的困扰：手机里的备忘录不够用，第三方笔记软件要么功能简陋要么隐私存疑，而像Notion这样的云端服务又受制于网络环境？今天我要分享的解决方案，或许能彻底改变你的移动知识管理方式——在安卓手机上搭建完全私有的Trilium笔记服务器。
这个方案的核心在于巧妙组合几个轻量级工具：Termux提供完整的Linux环境，Alpine Linux作为极简虚拟机系统，Docker则负责快速部署Trilium服务。整个过程不需要root权限，完成后你就能通过手机浏览器访问功能完整的私有笔记系统，所有数据都存储在本地，既安全又不受网络限制。下面我会分步骤详细讲解如何实现这个看似复杂实则优雅的解决方案。
1. 环境准备与基础配置
在开始之前，请确保你的安卓设备满足以下条件：
- 运行Android 7.0或更高版本
- 至少4GB可用存储空间（建议8GB以上）
- 处理器性能不低于骁龙6系列（实测778G运行流畅）
首先从F-Droid或GitHub获取Termux的最新安装包。强烈建议不要从第三方应用商店下载，以避免潜在的安全风险。安装完成后首次启动Termux，你会看到一个纯黑的终端界面——这就是我们的主战场。
执行基础环境更新（建议连接稳定的WiFi网络）：
pkg update -y && pkg upgrade -y接下来安装必要的软件包，这些将构成我们虚拟化环境的基础：
pkg install qemu-system-x86_64-headless qemu-utils openssh wget vim -y小技巧：如果下载速度较慢，可以尝试更换Termux的镜像源。编辑$PREFIX/etc/apt/sources.list文件，将默认的https://termux.net替换为国内镜像如https://mirrors.tuna.tsinghua.edu.cn/termux。
2. 创建Alpine Linux虚拟机
Alpine Linux以其极小的体积（基础镜像仅5MB左右）和安全性著称，非常适合作为轻量级虚拟机的操作系统。我们将使用专为虚拟化优化的virt版本。
创建一个专用工作目录并下载系统镜像：
mkdir ~/alpine && cd ~/alpine wget https://dl-cdn.alpinelinux.org/alpine/v3.21/releases/x86_64/alpine-virt-3.21.0-x86_64.iso为虚拟机分配存储空间。虽然Trilium本身不需要太大空间，但考虑到笔记可能包含附件，建议分配至少10GB：
qemu-img create -f qcow2 alpine.img 10G创建虚拟机启动脚本run.sh，这是整个方案的关键。特别注意网络配置部分：
#!/bin/bash qemu-system-x86_64 \ -machine q35 \ -m 2G \ -smp cpus=2 \ -cpu qemu64 \ -drive if=pflash,format=raw,read-only=on,file=$PREFIX/share/qemu/edk2-x86_64-code.fd \ -netdev user,id=n1,hostfwd=tcp::2222-:22,hostfwd=tcp::8090-:8080 \ -device virtio-net,netdev=n1 \ -cdrom alpine-virt-3.21.0-x86_64.iso \ -nographic alpine.img关键参数解析：
-m 2G：分配2GB内存（可根据设备性能调整）hostfwd=tcp::8090-:8080：将虚拟机的8080端口映射到手机的8090端口-nographic：以纯文本模式运行，节省资源
赋予执行权限后启动虚拟机：
chmod +x run.sh ./run.sh首次启动会进入Alpine的安装界面。按照提示完成以下关键步骤：
- 选择键盘布局（通常选us）
- 设置主机名（如trilium-server）
- 配置网络直接回车使用DHCP
- 时区选择Asia/Shanghai
- 安装介质选择virt
- 系统安装目标选择我们创建的alpine.img
- 最后输入
setup-alpine完成安装
安装完成后，修改run.sh去掉-cdrom参数，以后每次启动都会直接进入已安装的系统。
3. Alpine系统优化与Docker安装
进入Alpine系统后（用户名root，无密码），首先配置软件源加速后续安装：
sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories更新系统并安装基础工具：
apk update && apk upgrade apk add curl bash-completion htopDocker的安装比想象中简单得多，Alpine的包管理器已经包含了完整的Docker套件：
apk add docker docker-compose配置Docker开机自启并立即启动服务：
rc-update add docker boot service docker start常见问题：如果遇到cgroups相关错误，执行以下命令：
mkdir /sys/fs/cgroup/systemd mount -t cgroup -o none,name=systemd cgroup /sys/fs/cgroup/systemd验证Docker是否正常运行：
docker run --rm hello-world4. 部署Trilium笔记服务
我们选择nriver维护的中文版Trilium镜像，它对界面进行了完整汉化并优化了中文搜索体验。部署仅需单条命令：
docker run -d \ -p 8080:8080 \ --name trilium \ --restart=unless-stopped \ -v /root/trilium-data:/root/trilium-data \ -e TRILIUM_DATA_DIR=/root/trilium-data \ nriver/trilium-cn参数说明：
--restart=unless-stopped：确保容器意外退出后自动重启-v参数将数据持久化到虚拟机内/root/trilium-data目录- 默认用户名密码为admin/admin，首次登录后请立即修改
为了进一步增强数据安全性，建议定期备份/root/trilium-data目录。可以在Termux中设置定时任务：
crontab -e添加以下内容（每天凌晨3点备份）：
0 3 * * * tar -czf /data/data/com.termux/files/home/alpine/trilium-backup-$(date +\%Y\%m\%d).tar.gz /root/trilium-data5. 访问优化与进阶配置
现在你已经在手机上成功运行了一个完整的Trilium服务。通过手机浏览器访问http://localhost:8090即可使用。但我们可以进一步优化使用体验。
端口转发配置：如果你希望同一局域网下的其他设备也能访问，需要额外映射端口。修改run.sh中的网络参数：
-netdev user,id=n1,hostfwd=tcp::8090-:8080,hostfwd=tcp::2222-:22数据持久化：虚拟机的数据默认保存在alpine.img中。为了双重保险，可以将笔记数据同步到手机存储：
docker exec trilium sh -c 'tar -czf - /root/trilium-data' > /sdcard/trilium-backup.tar.gz性能调优：如果感觉响应较慢，可以尝试以下方法：
- 增加虚拟机内存（修改
run.sh中的-m参数） - 限制Trilium的内存使用：
docker update --memory 1G --memory-swap -1 trilium自动化脚本：创建完整的启动/停止脚本简化操作。在Termux中创建~/start_trilium.sh：
#!/bin/bash cd ~/alpine ./run.sh & sleep 30 adb forward tcp:8090 tcp:8090这个方案最吸引人的地方在于它的全离线可用性。一旦设置完成，你可以在没有互联网连接的情况下随时记录和查阅笔记，所有数据都安全地存储在你的手机上。对于经常需要在移动场景下处理敏感信息的用户来说，这提供了远比云服务更可靠的选择。