【01】ERPNext 快速部署指南：从 1Panel 准备到 5 分钟跑起来

NOTE

这是一篇综合入门指南，适合第一次接触 ERPNext 项目，想用最低的门槛、最快的速度在自己的服务器上把它跑起来的朋友。

Part 1：降低门槛 —— 为什么选择 1Panel 面板？

在部署 ERPNext 时，传统的方式是使用 Frappe 官方提供的 bench install 脚本直接在服务器的系统环境中安装。但很多小微团队或独立开发者在尝试这种方式时，常常会被各种依赖问题（Python 版本、Node.js 版本、Redis、MariaDB 等）折磨得痛苦不堪。

虽然使用纯 Docker Compose 部署能解决环境隔离的问题，但对于非专业的运维人员来说，日常的容器管理、日志查看、反向代理配置等，仍然需要敲击大量命令行。

因此，强烈推荐在开始部署 ERPNext 之前，先在服务器上安装 1Panel —— 一个现代化、开源的 Linux 面板。

1Panel 的核心优势

• 内置可视化 Docker Compose：无需手写命令，直接在 Web 界面粘贴配置即可一键拉起复杂的 ERPNext 集群。
• 直观的容器管理：点点鼠标即可重启服务、实时查看 db、backend 容器的日志，排查报错非常方便。
• 极简的反向代理与 HTTPS：自带 OpenResty 与自动化 Let's Encrypt 证书申请，几分钟内开启安全的域名 HTTPS 访问。

1Panel 极速安装指南（以 Ubuntu 为例）

如果你使用的是云服务器，推荐选择纯净的 Ubuntu 24.04 LTS。通过 SSH 登录后，执行官方提供的一键安装脚本：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

过程中需要设置端口、安全入口（随机字符串防扫描）和管理员账号密码。

云服务器必看

安装完成后，必须前往腾讯云或阿里云控制台，在 安全组（或防火墙）规则中，手动放行你刚刚设置的 1Panel 端口，否则无法通过浏览器打开后台！

登录 1Panel 后，如果系统提示是否安装 Docker 等依赖软件，请一律选择 安装。

---

Part 2：5 分钟快速启动 (基于 Docker Compose)

有了上述环境保障后，接下来我们就可以用极快的速度跑起基础镜像。

TIP

这里的极速启动适合想要先一睹为快的玩家。如果你希望直接搭建生产级别、支持多租户隔离的微型服务器环境，请参考下一篇文章 《基础安装指南：微型服务器与 1Panel 编排》。

1. 前置检查

确保你的服务器内存至少 4GB RAM（推荐 8GB），并且 8080 端口没有被别的服务占用。

2. 拿到配置文件并一键启动

在终端中执行以下命令（你也可以在 1Panel 的编排界面直接操作）：

git clone https://github.com/kingpy-tech/erpnext_china_opc.git
cd erpnext_china_opc
docker compose up -d

拉取速度

第一次拉镜像需要几分钟时间。可以在 1Panel 界面观察进度，或者执行 docker compose logs -f configurator，看到 exited with code 0 说明初始化就完成了。

3. 创建你的第一个站点（Site）

容器启动后，我们需要在其中创建一个独立的账套系统：

# 进入 backend 容器
docker compose exec backend bash

# 在容器内执行建站命令（将 mysite.localhost 换成你想用的域名即可）
bench new-site mysite.localhost \
  --mariadb-root-password admin \
  --admin-password admin \
  --install-app erpnext
  
# 完成后退出
exit

IMPORTANT

mysite.localhost 是站点名，本地可用，正式使用请替换为真实域名或内网 IP。 --admin-password admin 是你初次登录前台的默认密码，生产环境请务必更换！

4. 浏览器访问验证

在浏览器中打开：http://服务器IP或域名:8080

• 用户名：Administrator
• 密码：刚才设置的 admin

大功告成！欢迎进入开源企业管理的奇妙世界。接下来，让我们深入看看如何在微型服务器中部署生产级环境。