FluffOS 3.x 驱动在 Ubuntu 上的编译部署笔记

2026-08-15 · 分类：驱动架设 · 阅读约 7 分钟

这篇笔记记录把 FluffOS 3.x 驱动从源码编译到跑起来、再用 systemd 守护的完整过程，环境为 Ubuntu 22.04 LTS，内存 4G 以上即可。

安装依赖

sudo apt update
sudo apt install -y build-essential bison \
    libjemalloc-dev libpcre3-dev libssl-dev zlib1g-dev

其中 jemalloc 强烈建议装上，驱动在长时间运行下的内存表现会好很多。

获取源码并编译

git clone --depth 1 https://github.com/fluffos/fluffos.git
cd fluffos
./build.FluffOS
make -j$(nproc)

编译产物为 bin/driver。首次编译时间较长，耐心等 make 跑完即可。

修改配置

复制 etc/ 下的配置示例，重点修改三项：监听端口（port）、服务器外部地址（external_address）、mudlib 目录路径。配置文件名建议与运行环境绑定，区分测试服和正式服。

启动与守护

调试阶段前台启动，方便看日志：

./bin/driver config.ini

稳定后交给 systemd 管理：

[Unit]
Description=FluffOS MUD driver
After=network.target

[Service]
Type=simple
User=mud
WorkingDirectory=/opt/fluffos
ExecStart=/opt/fluffos/bin/driver /opt/fluffos/bin/config.ini
Restart=on-failure

[Install]
WantedBy=multi-user.target

别忘了防火墙放行端口：sudo ufw allow 4000/tcp。

踩坑记录

bison 版本过老会在编译期报语法错误，Ubuntu 20.04 自带的就可能踩到，升级 bison 即可。
systemd 单元里如果开了 ProtectHome=read-only，mudlib 目录不要放在 /home 下，否则无法写日志。
驱动对内存敏感，升级 mudlib 前先备份存档目录，测试服验证无误再同步到正式服。