x.erp 是一个给小店、小公司用的进销存 ERP：商品和库存、出入库单、销售采购、收付款和往来对账都有，全部功能免费、开源。以前只有飞牛 fnOS 版，现在有了 Docker 镜像，群晖、威联通、Unraid、绿联、极空间，或者任意一台能跑 Docker 的 Linux 机器都能装。
装好以后，局域网里的电脑、手机打开浏览器就能多人同时用，数据全部存在你自己的 NAS 里。不想先装也可以先到 在线演示 点点看（账号 admin，密码 admin123）。
一、准备
- 镜像地址：
ghcr.io/zyc009234/xerp:latest，同时支持 x86（amd64）和 ARM（arm64）。 - 端口：默认
8686。 - 数据目录：容器里的
/data，数据库、每日自动备份、日志都在这里。一定要映射到 NAS 的一个文件夹，否则删掉容器数据就没了。 - 国内网络拉不动
ghcr.io的话，到 下载页 下载离线镜像包（x86 设备选 amd64，ARM 设备选 arm64），后面讲怎么导入。
二、群晖（DSM 7.2 Container Manager）
- 在 File Station 里建一个文件夹，比如
/docker/xerp，用来放数据。 - 镜像：打开 Container Manager →「映像」→「新增」→「从 URL 添加」，填
ghcr.io/zyc009234/xerp:latest。拉取失败就改用「从文件添加」，选下载好的离线包。 - 打开「项目」→「新增」，项目名填
xerp，路径选刚才的/docker/xerp，来源选「创建 docker-compose.yml」，粘贴下面的内容：
services:
xerp:
image: ghcr.io/zyc009234/xerp:latest
container_name: xerp
restart: unless-stopped
ports:
- "8686:8686"
volumes:
- ./xerp-data:/data
environment:
- XERP_ADMIN_PASSWORD=改成你的初始密码- 下一步、完成，等容器状态变成「运行中」。
- 浏览器打开
http://群晖的IP:8686，用admin和上面设置的密码登录。
XERP_ADMIN_PASSWORD只在第一次启动时生效，至少 6 位；不填的话默认密码是admin123，登录后记得到 系统设置 → 我的账户 里改掉。
三、威联通（Container Station）
- Container Station →「应用程序」→「创建」，应用程序名称填
xerp。 - 把上面那段 docker-compose 内容粘进去，
./xerp-data可以改成共享文件夹的绝对路径，比如/share/Container/xerp。 - 点「创建」，启动后访问
http://威联通的IP:8686。
四、命令行（Unraid、绿联、极空间、普通 Linux）
能 SSH 登录的设备，一条命令就够了：
docker run -d --name xerp --restart unless-stopped \
-p 8686:8686 -v /你的路径/xerp-data:/data \
-e XERP_ADMIN_PASSWORD=你的初始密码 \
ghcr.io/zyc009234/xerp:latest用离线包的话，先上传到 NAS，再导入，导入后镜像名和上面一样，命令不用改：
docker load -i xerp-版本号-docker-amd64.tar.gz五、升级和备份
- 升级：拉取新镜像后重建容器。群晖在「项目」里先停止，再「操作 → 构建」；命令行是
docker pull ghcr.io/zyc009234/xerp:latest，然后删掉旧容器、用同样的命令重新运行。数据在映射的文件夹里，不会丢。 - 备份：x.erp 每天自动在
/data/backups里留一份数据库，保留 30 天；系统设置 → 数据管理 里也能导出完整备份。把映射的数据文件夹纳入 NAS 自己的备份任务就更稳了。 - 匿名统计：x.erp 每天会匿名上报一次版本号用于统计装机量，不带任何业务数据，可以在 系统设置 里关掉，或者启动时加
-e XERP_STATS_URL=。
六、装好以后
第一次登录会带一套演示数据，可以先随便点点。正式使用前到 系统设置 → 数据管理 里清空业务数据，再按 《x.erp 入门教程》 录商品、开第一张入库单。需要销售、采购、财务时，到 系统设置 → 常规设置 里打开对应模块。
手机上想扫码出入库，可以装安卓客户端，用法见 《手机扫码出入库》。用起来有问题，或者想要什么功能，在软件左侧「问题反馈」里留言就行。