
1. 项目概述最近在折腾一个很有意思的项目——用玩客云搭建个人思源笔记服务器。这个方案最大的优势就是成本极低基本上只需要花几十块钱买个二手玩客云设备其他都可以用闲置配件搞定。我自己已经稳定运行了一个多月实测下来非常可靠。思源笔记作为一款本地优先的Markdown笔记软件最大的痛点就是多设备同步需要付费订阅。通过Docker部署思源服务可以让所有设备访问同一个服务端完美解决同步问题。而且7×24小时运行随时随地都能访问笔记。2. 硬件准备2.1 玩客云设备选购玩客云现在海鲜市场价格在35-50元左右建议选择V1.3版本白色边框较大二维码较小带原装电源最好包含公对公USB线刷机必备已刷过机的设备优先省去拆机短接的麻烦我用的是一台闲置的V1.3版玩客云当年矿潮时留下的相当于零成本。2.2 存储设备选择玩客云本身存储只有1GB必须外接存储推荐闲置的2.5寸机械硬盘或SSD也可用SD卡/TF卡但读写性能较差必须格式化为ext4或NTFS文件系统重要提示绝对不能使用FAT32/ExFAT格式我用的是一块闲置的128GB SSD加USB硬盘盒成本也就30块钱。3. 系统安装与配置3.1 刷入OpenWrt系统下载刷机工具包Burning Tool获取OpenWrt固件推荐使用openwrt.ai定制连接玩客云和电脑使用公对公USB线使用Burning Tool刷入固件注意如果刷机报错尝试更换USB接口或电脑。玩客云上电时要先按住复位键。3.2 OpenWrt基础配置刷机完成后用网线连接玩客云和电脑设置电脑IP为192.168.10.x非100访问192.168.10.100默认密码root修改LAN口IP为路由器同网段如192.168.1.100建议将玩客云直接连接主路由器确保所有设备都能访问。4. Docker环境配置4.1 修改Docker存储路径为了避免玩客云内置存储空间不足在挂载点确认外接存储已识别如/mnt/sda1修改Docker根目录为外接存储如/mnt/sda1/docker重启Docker服务4.2 配置镜像加速国内拉取Docker镜像很慢需要配置镜像源https://docker.mybacc.com https://docker.1ms.run在Docker配置页面添加以上任意一个镜像地址即可。5. 思源笔记部署5.1 拉取思源镜像通过SSH登录玩客云执行docker pull b3log/siyuan:latest或者使用Web界面在Docker-镜像中拉取。5.2 创建思源容器使用以下命令创建容器docker run --network host \ -p 6806:6806 \ --name siyuan \ -v /mnt/sda1/siyuan/:/siyuan/workspace \ -e PUID1001 \ -e PGID1002 \ -d b3log/siyuan \ --workspace/siyuan/workspace \ --accessAuthCode你的密码参数说明-v参数将数据目录映射到外接存储accessAuthCode是网页端登录密码PUID/PGID建议设为1001/10025.3 访问思源服务容器启动后通过浏览器访问http://192.168.1.100:6806输入之前设置的密码即可使用。所有笔记数据都会保存在外接存储中。6. 内网穿透配置可选6.1 使用cpolar实现外网访问拉取cpolar镜像docker pull probezy/cpolar运行容器docker run -id --network host --name cpolar probezy/cpolar配置authtokendocker exec -it cpolar /bin/bash cpolar authtoken 你的token创建思源笔记的隧道映射6806端口6.2 注意事项免费版cpolar的域名会随机变化每次外网访问需要登录cpolar官网查看最新域名或升级付费套餐获取固定域名7. 维护与优化7.1 数据备份方案建议定期备份/mnt/sda1/siyuan目录使用rsync同步到其他设备或打包压缩后上传到网盘也可配置自动备份脚本7.2 性能优化技巧关闭不需要的Docker服务定期清理Docker日志和缓存为思源笔记配置swap空间避免同时进行大量文件操作8. 常见问题排查8.1 思源服务无法启动检查步骤查看容器日志docker logs siyuan确认存储权限正确检查端口是否被占用8.2 外接存储识别异常解决方法重新插拔存储设备检查/etc/config/fstab配置尝试手动挂载mount /dev/sda1 /mnt/sda18.3 网络连接问题排查方法ping测试玩客云IP检查防火墙规则确认路由器端口转发设置这套方案我已经稳定运行了一个多月完全满足个人笔记需求。相比付费订阅不仅省了钱数据还完全掌握在自己手里。后续还可以扩展更多Docker服务比如搭建个人网盘、RSS阅读器等。