本文基于 frappe/erpnext:v16.29.0，Ubuntu 24.04实测。

报价、采购单、入库出库、销售开票、应收应付……公司一大，这些单据就散落在 Excel、微信群和好几套互不相通的小软件里：库存对不上账、财务月底对账靠人肉、销售一问交期仓库答不上来。商业 ERP / SaaS 能把流程串起来，但授权贵、定制慢，关键主数据还躺在厂商云上——合规要求「数据不出域」、内网要断公网、或只是想少一份年费时，就需要一套可自托管的开源 ERP。

ERPNext是 Frappe Technologies 维护的免费开源企业资源规划（ERP）系统，跑在自家的Frappe低代码框架上。同一套 Web Desk 里集成财务会计（总账、应收应付、发票与报表）、供应链（采购、库存、销售）、生产制造（BOM、工单、委外）、固定资产、项目与质量，以及公司 / 用户 / 权限等组织主数据；业务流程可按行业勾选模块，单据之间能互相带出，减少「多系统对账」。源代码可按需二次开发，无按席位收取的许可费。实例跑在你自己的 Docker 主机上，库表与附件落在本地卷里——浏览器打开就能管进销存与账本，不必把核心经营数据绑死在某一家公有云 ERP。

上手不是「拉一个容器」那么简单。官方运行时镜像要配合MariaDB + 双 Redis + backend / frontend / worker / scheduler / websocket多服务栈。国内又常访问不了 GitHub，没法直接git clone frappe_docker。本文按「能跟做」写完整链路：用 轩辕镜像 加速域docker.xuanyuan.run拉取frappe/erpnext:v16.29.0+mariadb:11.8+redis:6.2-alpine，在本地目录粘贴完整 Compose（逻辑对齐官方演示栈pwd.yml，无需 clone），等create-site建站完成后访问8080，走完登录与 Welcome 向导，再把界面切到简体中文（实测：搜Chinese会 No Results，应搜「中文」或zh），并逛一眼组织、会计、资产、库存、生产与全局默认值。Ubuntu 24.04全程实测，附15 张截图、运维命令与 FAQ。

说明：本文 Compose 用于短期试用 / 学习，不是生产加固方案。生产请参考官方 frappe_docker 的compose.yaml+ overrides（可在能访问外网的环境准备，或自行内嵌 YAML）。默认管理员密码仅演示用，上线务必修改。

镜像说明见 frappe/erpnext 镜像页，标签列表见 tags。上游项目：ERPNext；用户文档：docs.erpnext.com。

图 1：浏览器打开 8080 后的登录页

一、ERPNext 是什么？

ERPNext面向中小企业与成长型团队，把「进销存 + 财务 + 生产」收拢到一个浏览器工作台（Desk）。它不是单一进销存插件，而是按模块拼装的一体化平台：开票与收款进会计科目，采购收货进库存余额，工单耗料再回写成本——单据链路打通后，报表才有可信度。

核心能力一览：

和「只做库存的进销存」或「只做记账的财务软件」相比，ERPNext 的价值在于同一主数据、多模块协同：客户 / 供应商 / 物料只维护一份，销售、采购、仓库、财务共用。代价是栈更重（数据库 + 缓存队列 + 多进程），部署与运维门槛高于单容器小工具——这也是本文用 Compose 多服务跟做的原因。

典型场景：贸易/电商后台的进销存与对账、小型工厂的 BOM 与工单、需要私有化试点以替代昂贵 SaaS ERP 的团队。全球社区持续维护版本线（本文为v16）；中文界面可用，但个别术语翻译可能未 100% 覆盖。

版本与依赖：本文使用frappe/erpnext:v16.29.0，配套MariaDB 11.8、Redis 6.2。生产请固定三位版本号，勿用latest/develop。

架构（本文演示栈）：

浏览器 ──HTTP:8080──▶ frontend (nginx) │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ backend:8000 websocket:9000 sites/logs 卷 │ ┌────┼────┬────────────┐ ▼ ▼ ▼ ▼ MariaDB redis-cache redis-queue queue/scheduler

二、环境要求

docker--versiondockercompose version

Linux 未装 Docker：

bash<(wget-qO- https://xuanyuan.cloud/docker.sh)

ARM 主机若误拉 amd64 会走模拟变慢，可在 compose 各服务加platform: linux/arm64。

三、标签怎么选

标签列表：xuanyuan.cloud/r/frappe/erpnext/tags。

四、拉取镜像（轩辕加速）

上游为 Docker Hub（docker.io）。公共登录域docker.xuanyuan.run：首次需docker login；已登录则直接 pull。规范见 agents.md。

grep-q'"docker.xuanyuan.run"'~/.docker/config.json&&echo"已登录"||echo"未登录"# 未登录时：# docker login docker.xuanyuan.run

sudomkdir-p/www/wwwroot/erpnextcd/www/wwwroot/erpnextdockerpull docker.xuanyuan.run/frappe/erpnext:v16.29.0dockerpull docker.xuanyuan.run/library/mariadb:11.8dockerpull docker.xuanyuan.run/library/redis:6.2-alpine

实测拉取摘要：

Digest: sha256:a951e8c905161ec50246d5f6da8e324d89ffb8bb3b407b3508208890f6a9483c Status: Downloaded newer image for docker.xuanyuan.run/frappe/erpnext:v16.29.0 Digest: sha256:efb4959ef2c835cd735dbc388eb9ad6aab0c78dd64febcd51bc17481111890c4 Status: Downloaded newer image for docker.xuanyuan.run/library/mariadb:11.8 Digest: sha256:ec5e187c913d422cdf60f4216a5fdfb95246792c6de6fe21ff5bed75cbfc8c23 Status: Downloaded newer image for docker.xuanyuan.run/library/redis:6.2-alpine

失败时按错误码分流（401→登录，402→充值，manifest→核对标签），不要默认改回 Docker Hub 直拉。

五、部署：免 clone 的完整 Compose

不要依赖git clone https://github.com/frappe/frappe_docker（国内常连不上）。在目录内新建docker-compose.yml，粘贴下文即可。

5.1 完整 docker-compose.yml

# docker-compose.yml — ERPNext 演示栈（基于 frappe_docker pwd.yml）# 访问 http://<主机IP>:8080 账号 Administrator / adminservices:backend:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:on-failurevolumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsenvironment:DB_HOST:dbDB_PORT:"3306"MYSQL_ROOT_PASSWORD:adminMARIADB_ROOT_PASSWORD:admindepends_on:configurator:condition:service_completed_successfullyconfigurator:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:noneentrypoint:-bash--ccommand:->ls -1 apps > sites/apps.txt; bench set-config -g db_host $$DB_HOST; bench set-config -gp db_port $$DB_PORT; bench set-config -g redis_cache "redis://$$REDIS_CACHE"; bench set-config -g redis_queue "redis://$$REDIS_QUEUE"; bench set-config -g redis_socketio "redis://$$REDIS_QUEUE"; bench set-config -gp socketio_port $$SOCKETIO_PORT;environment:DB_HOST:dbDB_PORT:"3306"REDIS_CACHE:redis-cache:6379REDIS_QUEUE:redis-queue:6379SOCKETIO_PORT:"9000"volumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logscreate-site:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:nonevolumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsentrypoint:-bash--ccommand:->wait-for-it -t 120 db:3306; wait-for-it -t 120 redis-cache:6379; wait-for-it -t 120 redis-queue:6379; export start=`date +%s`; until [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".db_host // empty"` ]] && \ [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".redis_cache // empty"` ]] && \ [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".redis_queue // empty"` ]]; do echo "Waiting for sites/common_site_config.json to be created"; sleep 5; if (( `date +%s`-start > 120 )); then echo "could not find sites/common_site_config.json with required keys"; exit 1 fi done; echo "sites/common_site_config.json found"; if [ -d "sites/frontend" ]; then echo "Site frontend already exists, skipping creation"; else bench new-site --mariadb-user-host-login-scope='%' --admin-password=admin --db-root-username=root --db-root-password=admin --install-app erpnext --set-default frontend; fi;db:image:docker.xuanyuan.run/library/mariadb:11.8networks:-frappe_networkhealthcheck:test:["CMD","healthcheck.sh","--connect","--innodb_initialized"]start_period:5sinterval:5stimeout:5sretries:5deploy:restart_policy:condition:on-failurecommand:---character-set-server=utf8mb4---collation-server=utf8mb4_unicode_ci---skip-character-set-client-handshakeenvironment:MYSQL_ROOT_PASSWORD:adminMARIADB_ROOT_PASSWORD:adminvolumes:-db-data:/var/lib/mysqlfrontend:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdepends_on:-websocket-backenddeploy:restart_policy:condition:on-failurecommand:-nginx-entrypoint.shenvironment:BACKEND:backend:8000FRAPPE_SITE_NAME_HEADER:frontendSOCKETIO:websocket:9000UPSTREAM_REAL_IP_ADDRESS:127.0.0.1UPSTREAM_REAL_IP_HEADER:X-Forwarded-ForUPSTREAM_REAL_IP_RECURSIVE:"off"PROXY_READ_TIMEOUT:120CLIENT_MAX_BODY_SIZE:50mvolumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsports:-"8080:8080"queue-long:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:on-failurecommand:-bench-worker---queue-long,default,shortvolumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsenvironment:FRAPPE_REDIS_CACHE:redis://redis-cache:6379FRAPPE_REDIS_QUEUE:redis://redis-queue:6379depends_on:configurator:condition:service_completed_successfullyqueue-short:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:on-failurecommand:-bench-worker---queue-short,defaultvolumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsenvironment:FRAPPE_REDIS_CACHE:redis://redis-cache:6379FRAPPE_REDIS_QUEUE:redis://redis-queue:6379depends_on:configurator:condition:service_completed_successfullyredis-queue:image:docker.xuanyuan.run/library/redis:6.2-alpinenetworks:-frappe_networkdeploy:restart_policy:condition:on-failurevolumes:-redis-queue-data:/dataredis-cache:image:docker.xuanyuan.run/library/redis:6.2-alpinenetworks:-frappe_networkdeploy:restart_policy:condition:on-failurescheduler:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:on-failurecommand:-bench-schedulevolumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsdepends_on:configurator:condition:service_completed_successfullywebsocket:image:docker.xuanyuan.run/frappe/erpnext:v16.29.0networks:-frappe_networkdeploy:restart_policy:condition:on-failurecommand:-node-/home/frappe/frappe-bench/apps/frappe/socketio.jsenvironment:FRAPPE_REDIS_CACHE:redis://redis-cache:6379FRAPPE_REDIS_QUEUE:redis://redis-queue:6379volumes:-sites:/home/frappe/frappe-bench/sites-logs:/home/frappe/frappe-bench/logsdepends_on:configurator:condition:service_completed_successfullyvolumes:db-data:redis-queue-data:sites:logs:networks:frappe_network:driver:bridge

数据落在 Compose命名卷（sites/logs/db-data/redis-queue-data），无需再挂宿主机子目录。

5.2 启动与建站日志

cd/www/wwwroot/erpnextdockercompose up-ddockercompose logs-fcreate-site

实测启动成功时大致为：

✔ Network erpnext_frappe_network Created ✔ Volume erpnext_redis-queue-data Created ✔ Volume erpnext_sites Created ✔ Volume erpnext_logs Created ✔ Volume erpnext_db-data Created ✔ Container erpnext-db-1 Started ✔ Container erpnext-redis-queue-1 Started ✔ Container erpnext-create-site-1 Started ✔ Container erpnext-configurator-1 Exited ✔ Container erpnext-redis-cache-1 Started ✔ Container erpnext-queue-long-1 Started ✔ Container erpnext-backend-1 Started ✔ Container erpnext-queue-short-1 Started ✔ Container erpnext-scheduler-1 Started ✔ Container erpnext-websocket-1 Started ✔ Container erpnext-frontend-1 Started

create-site正常结束示例：

wait-for-it: db:3306 is available after 28 seconds sites/common_site_config.json found Installing frappe... Installing erpnext... Current Site set to frontend create-site-1 exited with code 0

首次建站可能要数分钟。看到exited with code 0后再打开浏览器。

访问：http://<服务器IP>:8080
默认账号：Administrator/admin（仅演示）。

六、浏览器：登录与 Welcome 向导

6.1 登录

打开http://<IP>:8080，进入Sign In。邮箱可填Administrator，密码admin，点Continue。

图 1：登录页

6.2 Welcome：语言 / 国家 / 时区 / 货币

首次会进入Welcome。国家选China后，时区常见为Asia/Chongqing，货币CNY。
语言默认常为English——不会因选了 China 自动变中文。若此处下拉不好用，可先英文走完向导，登录后再改（见第七节）。

图 2：Welcome——语言、国家、时区、货币

6.3 创建账户

填写Full Name、Email Address（登录 ID）、Password，点Next。

图 3：Let’s set up your account

6.4 业务画像与模块

按提示选择团队规模、工作类型等，并可勾选计划启用的模块（如 Accounting、Manufacturing、Stock、Project Management）。

图 4：A little about you——模块勾选

6.5 等待初始化

出现Setting up your system/Starting Frappe …时耐心等待，完成后进入 Desk。

图 5：系统初始化进度

七、切换简体中文（重要踩坑）

7.1 为什么搜 Chinese 没有结果？

语言显示名是「简体中文」（代码zh），不是英文词Chinese。在 Language 的 Autocomplete 里搜Chinese会显示No Results——这不代表镜像没有中文。

正确做法（已实测）：

1. 打开用户资料（或 Awesome Bar 搜 User）→ 找到Language
2. 清空原有English，输入中文或zh
3. 选中结果（如zh/ 中文）→Save
4. 等待Refreshing…，再Ctrl+Shift+R强刷

图 7：搜索「中文」即可匹配到 zh

图 8：Language 保存为中文，页面刷新中

命令行兜底（站点名本栈为frontend）：

dockercomposeexecbackend bench--sitefrontend set-language zhdockercomposeexecbackend bench--sitefrontend clear-cache

7.2 中文 Desk 主页

切换成功后，主页图标为中文模块名：组织、会计、资产、采购、生产、项目、质量、销售、库存、委外、ERPNext 设置等。

图 6：简体中文 Desk 首页

部分菜单/术语仍可能夹杂英文，属社区翻译覆盖不全，属正常。

八、功能演示：组织、会计、资产、库存、生产与设置

以下截图用于熟悉系统，演示数据来自实测环境（公司名示例「轩辕镜像」）。

8.1 组织：公司列表

进入组织，可见公司主数据（国家中国、货币 CNY）。右下角Getting Started会提示完成公司、用户、邮箱、权限等引导步骤。

图 9：组织——公司列表

8.2 会计：快捷入口与开票工作区

点击会计可看到开票、付款、报表、税、银行等快捷入口；进入开票管理可见损益相关图表与应收应付入口。

图 10：会计——功能快捷入口

图 11：开票管理工作区

8.3 资产

资产模块提供固定资产价值分析、折旧、维护等入口；新站点图表可能为空，按 Getting Started 逐步建分类与资产即可。

图 12：资产工作区

8.4 库存与生产

继续点开库存、生产等工作区：左侧为单据与报表导航，中间为趋势图与 KPI（新站多为 0），右下角有模块向导。

图 13：库存等工作区

图 14：生产工作区

8.5 全局默认值

在ERPNext 设置 → 全局默认值可核对默认公司、国家、默认货币（CNY）等，改完点Save。

图 15：全局默认值

官方语言说明：Set Language。

九、运维命令速查

cd/www/wwwroot/erpnextdockercomposeps-adockercompose logs-ffrontenddockercompose logs-fbackenddockercompose logs-fcreate-site# 改语言兜底dockercomposeexecbackend bench--sitefrontend set-language zhdockercomposeexecbackend bench--sitefrontend clear-cache# 停止 / 销毁（演示环境可直接 down；加 -v 会删命名卷数据）dockercompose down# docker compose down -v

十、FAQ

Q：能不能docker run单个 erpnext 容器？
A：不能当完整 ERP 用。需要 MariaDB、Redis 与多个进程角色，请用本文 Compose。

Q：国内 clone 不了 frappe_docker 怎么办？
A：不必 clone。把本文docker-compose.yml存到本地目录即可。

Q：CPU 有没有 AVX 之类限制？
A：无 AVX 硬性要求。v16.29.0支持 amd64/arm64。真正卡点是内存与核数（建议 ≥4 GB / 2 核起）。

Q：搜 Chinese 没有语言？
A：搜「中文」或zh。详见第七节。

Q：create-site 一直不退出？
A：看docker compose logs -f create-site与db日志；确认内存够用、8080 未被占用。正常结束为exited with code 0。

Q：默认密码安全吗？
A：Administrator/admin与库 root 密码admin仅演示。公网暴露前必须改密并加防火墙 / 反代 HTTPS。

Q：这套能直接上生产吗？
A：不建议。请改用官方生产 Compose（HTTPS、密码、备份、资源限制等），本文仅作试用。

十一、延伸阅读

• frappe/erpnext 镜像页
• frappe/erpnext 镜像标签列表
• 轩辕镜像 agents.md
• ERPNext 文档
• Set Language
• frappe_docker（官方容器编排，需可访问 GitHub）
• ERPNext 源码仓库