x.erp 入门教程：10 分钟把仓库搬进飞牛 NAS

x.erp 是一个装在飞牛 NAS（或一台常开的 Windows 电脑）上的轻量 ERP。装好以后，局域网里任何一台电脑打开浏览器就能用，多人可以同时开单，数据始终在你自己的设备里，不联网也能用。基础功能永久免费。

这篇教程按第一次上手的顺序来：安装 → 基本设置 → 录入商品 → 开入库单 → 开出库单 → 查库存。照着做一遍，大约 10 分钟。

一、安装

先到 x.erp 下载页 下载对应的安装包。

装在飞牛 NAS 上（推荐）

1. 下载 xerp-版本号.fpk。
2. 打开飞牛「应用中心」，点左下角「手动安装」，选择刚才的 fpk。依赖的 Node.js v22 会自动装好，不用 Docker，也不用命令行。
3. 安装向导里设置管理员密码。账号固定是 admin，密码至少 6 位。
4. 装好后点桌面上的「x.erp」图标。局域网里的其他电脑用浏览器访问 http://NAS的IP:8686。

装在 Windows 电脑上

没有 NAS 也可以：在店里或办公室找一台常开的 Windows 10 / 11 电脑，双击 xerp-版本号-windows-x64-setup.exe，向导里设好端口和管理员密码就行。它会作为后台服务开机自启，不用登录 Windows。其他电脑访问 http://这台电脑的IP:8686。

升级时直接下载新版覆盖安装，数据不会丢。

二、首次登录后先做这几件事

第一次打开会自带一套演示数据（商品、客户、单据），可以先随便点点熟悉界面。准备正式使用时：

1. 改公司名称：系统设置 → 常规设置 → 公司名称。它会印在所有单据的抬头上。
2. 给同事开账号：系统设置 → 用户管理 → 新增用户，每人选一个角色。系统预置了仓库主管、仓管员、入库员、出库员、盘点员、成本会计、只读查询等 9 个角色，比如仓管员只能开单、看不到成本金额。角色里的权限也能逐项改。
3. 再建一个管理员：万一一个管理员忘了密码，另一个可以在「用户管理」里帮他重置。
4. 清空演示数据：系统设置 → 数据管理 →「清空业务数据」。账号会保留，商品和单据全部清掉。

x.erp 默认只开启「库存管理」和「商品管理」，界面很清爽。需要销售、采购、客户往来、财务、人事时，到 系统设置 → 常规设置 → 启用的功能模块 里勾上。

三、录入商品

到「商品管理 → 新增商品」，主要填这些：

• 商品编码（必填，不能重复）和条码：条码留空时，扫码枪扫商品编码也能识别。
• 基本单位：库存按它记，比如「个」「瓶」。
• 辅助单位（选填）：例如填 箱=12，以后开单就能直接按箱录入，系统自动换算成 12 个。箱子上有自己的条码就写成 箱=12/6901234567890，扫箱码时会自动选「箱」。可以填多个，用分号隔开，比如 箱=12；提=6。
• 安全库存：库存低于这个数会出现在预警里。
• 期初库存和期初成本价：现有的货填在这里，系统会记一笔「期初库存」流水。

商品多？用 Excel 一次导入

在「商品管理 → 导入」（或「库存管理 → 导入商品 / 期初」）里先下载模板，按列填好商品编码、名称、规格、单位、成本价、销售价、期初库存，再上传。导入前会逐行预览和校验，只要有一行出错，整批都不会写进去，改好再传就行。同一个编码再导一次会更新商品资料，可以拿来批量改价。

四、开入库单

进货、退货、生产完工都开入库单：「库存管理 → 出入库单 → 入库」。

1. 选入库类型：采购入库、生产入库、退货入库、其他入库。
2. 填供货单位和经手人，可以直接输入，也可以从下拉里选以前用过的。
3. 录入商品：在「商品」格里用扫码枪扫一下，或者输入编码、名称搜索后回车，光标会自动跳到下一行，可以一直扫下去。重复扫同一个商品，数量会自动 +1。
4. 设了辅助单位的商品，「单位」是一个下拉框，可以选「箱」，数量和单价都按箱填。
5. 填单价：系统用移动加权平均法自动重算成本，以后出库就按这个成本计价。
6. 点「保存」，或者「保存并打印」。

单据可以打印成 A4、二等分（针式打印机常用的 241×140）或 A5，带金额大写和签字栏。开错了不要删，在单据详情里点「作废」，库存会自动扣回来，留有记录。

五、开出库单

领料、销售发货、报损都开出库单：「库存管理 → 出入库单 → 出库」，操作和入库单一样。不同的地方有三点：

• 库存不够时，数量会标红，保存也会被拦下，不会出现负库存。
• 不用填单价，系统按当前的移动加权成本自动计价，毛利算得准。
• 作废出库单时，货会退回库存。

小技巧：出库单抬头想叫「送货单」？到 系统设置 → 打印模板，把出库单的标题改掉。还可以在公司名下加地址和电话、底部加一句「货物当面点清」、只打印需要的列，右边能实时预览效果。

六、查库存

• 库存总览：每个商品的当前库存、安全库存和库存水位。设了辅助单位的，会同时显示成「25箱 3个」这样的写法。
• 库存预警：低于安全库存的商品会集中列出，右上角的铃铛也会提醒。
• 出入库流水：每一笔库存变化都有记录，包括谁、什么时候、哪张单据。
• 收发存汇总：选任意一段时间，看期初、入库、出库、期末的数量和金额。点开商品能看到逐笔明细账，月底对账很方便。

库存清单、流水和汇总表都能导出成 Excel（CSV）或直接打印。

七、在手机上用

下载安卓 App（xerp-版本号-android.apk，Android 7.0 及以上），手机连上和 NAS 同一个 Wi-Fi，打开后点「自动查找」就能连上服务器。右下角有扫码按钮，可以用手机摄像头扫条码开单、盘点、查库存。

八、数据安全

• x.erp 每天自动备份数据库，保留最近 30 天。也可以在 系统设置 → 数据管理 → 导出备份，存一份到自己电脑上。
• 8686 端口不要直接映射到公网，在飞牛防火墙里只放行局域网就好。
• 飞牛版的数据在 /vol*/@appdata/xerp，Windows 版在 C:\ProgramData\XERP。卸载应用前请先导出备份。