ERPNext 首次登录与基础配置

你刚装好系统，打开浏览器看到 ERPNext 登录页面。接下来每一步该做什么？这份文档陪你走完从登录到发出第一封邮件的全过程。

1. 登录第一件事：Setup Wizard

1.1 你看到的是什么

用 Administrator 和你设置的密码登录后，系统会自动弹出一个设置向导。这个向导只出现一次，但可以之后在设置中重新打开。

它会引导你完成：

选择国家、时区、货币
创建公司
设置会计科目表
设置默认科目

1.2 每一步怎么选

第一步：选择国家和时区

Country: China
Time Zone: Asia/Shanghai
Currency: CNY

这三项看起来简单，但直接影响之后的所有功能。选了 China 之后，日期格式、数字格式、默认科目表模板都会按中国标准来。

第二步：创建你的第一个公司

这里填的是你公司的基本信息。每一项的含义：

字段	怎么填	注意
Company Name	公司全名（营业执照上的名字）	这个会出现在所有发票上
Abbreviation	公司简称，2-5 个字母	会出现在单据编号里，如 ABC-INV-2026-00001
Default Currency	CNY	人民币
Country	China
Chart of Accounts	选 "中国会计科目表" 或 "Standard Template" → 选 China	如果列表里没有中国选项，说明镜像里的中国 COA 不完整
Domain	Distribution（贸易）/ Manufacturing（制造）/ Services（服务）/ Retail（零售）	选你的行业，影响系统默认启用哪些模块

第三步：设置默认科目

系统会要求你为常见业务选择默认的会计科目。如果你不确定，可以暂时用系统推荐的值，之后随时可以改。

需要选择的核心科目：

场景	说明	建议
Default Receivable Account	销售后记录应收款用哪个科目	应收账款
Default Payable Account	采购后记录应付款用哪个科目	应付账款
Default Income Account	销售收入记哪个科目	主营业务收入
Default Expense Account	费用记哪个科目	根据你的行业选
Default Cost of Goods Sold Account	销售成本记哪个科目	主营业务成本
Default Cash Account	现金收款	库存现金
Default Bank Account	银行收款	银行存款

如果你不确定，没关系。 这些都是默认值，意思是创建新单据时自动填入。之后每张单据上都可以手动改。

1.3 Setup Wizard 完成后你会看到什么

完成向导后，你会看到 ERPNext 的主页面（叫 Desk）。左边是模块菜单，中间是工作区。

如果你看到的大多是英文： 这就是运维指南 2.1 节提到的问题——中文翻译不全。你可以按运维指南的方案创建翻译补丁。

2. 创建你的公司

如果 Setup Wizard 里已经完成了公司创建，跳过本节。如果还需要完善或修改：

路径：Accounting → Company → 打开你的公司

需要完善的信息：
  □ 公司地址（发票上显示）
  □ 公司电话（发票上显示）
  □ 公司税号（需先创建自定义字段，见运维指南 3.1）
  □ 银行账户（收款时显示）
  □ 公司 Logo（打印格式上显示）

3. 配置基础财务信息

3.1 设置会计年度

路径：Accounting → Fiscal Year → New

中国的会计年度：1 月 1 日 — 12 月 31 日

为什么需要这个？ 系统需要知道你的会计年度起止日期，才能正确生成年报、计算利润。如果不设置，系统会用一个默认的年度。

3.2 创建你的银行账户

路径：Accounting → Bank → New

每一项的含义：
  Bank Name：开户行全称（如"中国工商银行股份有限公司XX支行"）
  Account Number：银行账号（数字绝对不能写错！）
  Company：你的公司
  Currency：CNY
  Account：选择对应的会计科目（银行存款）

注意：银行账号会出现在发票上。务必逐位核对。

3.3 设置默认科目（如果 Wizard 里没做全）

路径：Accounting → Company → 你的公司 → 向下翻到 "Default Accounts" 区域

4. 邮箱配置：让系统能发邮件

4.1 为什么必须配邮箱？

没有邮箱，以下功能全都不能用：

用户忘记密码 → 无法重置（只能管理员在命令行重置）
审批通知 → 经理不知道有单据等他审批
自动发送单据给客户 → 生成发票后没法直接发给客户
系统告警 → 监控脚本发现了问题，但没法通知你

4.2 先理解：你是用谁的邮箱发？

ERPNext 自己不提供邮箱服务。你需要借用一个已有的邮箱账号来发送系统邮件。就像一个快递员用公司的名义寄信——信是 ERPNext 写的，但信封上的发件地址是你公司的邮箱。

推荐： 单独注册一个公司专用的邮箱（如 noreply@你公司.com 或 erp@你公司.com），不要用个人邮箱。

4.3 各邮箱服务商的配置

企业微信邮箱（推荐，国内最稳定）：

1. 登录企业微信管理后台 → 应用管理 → 邮箱
2. 新建一个邮箱账号，如 erp@你的公司域名.com
3. 记录 SMTP 服务器信息：
   SMTP Server: smtp.exmail.qq.com
   Port: 465
   加密方式: SSL/TLS

QQ 邮箱：

1. 登录 QQ 邮箱网页版 → 设置 → 账户
2. 往下翻找到 "POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务"
3. 开启 "SMTP 服务"
4. 系统会要求你发一条短信验证 → 验证通过后会显示一个 16 位的"授权码"
   → 复制这个授权码！它就是你在 ERPNext 里要填的"密码"

   ⚠ 注意：授权码不是你的 QQ 密码！不开启 SMTP 服务就没有授权码！

163 邮箱：

1. 登录 163 邮箱网页版 → 设置 → POP3/SMTP/IMAP
2. 开启 "SMTP 服务"
3. 同样会生成一个授权码，复制保存

4.4 在 ERPNext 中配置

路径：Settings → Email Account → New

填写内容：

  Email Address:        erp@你的公司.com        （发件人地址）
  Email Account Name:   公司ERP系统邮件           （随便起个名字）
  Email Service:        Custom                   （自定义）
  Enable Outgoing:      勾选                      （允许发邮件）
  SMTP Server:          smtp.exmail.qq.com        （你的 SMTP 地址）
  SMTP Port:            465                       （你的端口）
  Use TLS:              勾选                      （加密传输）
  Username:             你的邮箱地址（同 Email Address）
  Password:             你的授权码（不是登录密码！）

  然后点 Save。

4.5 测试邮件是否配置成功

# 在容器里执行测试
docker compose exec backend bench --site mysite console << 'PY'
import frappe

frappe.sendmail(
    recipients=["你自己的邮箱@qq.com"],
    subject="测试邮件 - ERPNext",
    message="如果你收到这封邮件，说明邮件配置成功。发送时间：" + frappe.utils.now()
)
print("✅ 测试邮件已发送，请检查收件箱（也检查一下垃圾邮件箱）")
PY

4.6 邮件发不出的常见原因

症状	原因	解决
报错 `Authentication failed`	密码填错了，或者没用授权码	去邮箱设置里重新获取授权码
报错 `Connection refused`	SMTP 地址或端口写错了	检查配置和你邮件服务商提供的一致
测试显示发送成功但收不到	被拦截到垃圾邮件箱了	检查垃圾邮件箱，把发件地址加白名单
报错 `Network is unreachable`	服务器（容器）不能访问外网	检查服务器网络设置、防火墙规则
QQ/163 提示"授权码过期"	授权码有有效期	重新生成一个授权码

5. 验证一切正常

走完以上步骤后，执行以下验证：

□ 用 Administrator 能正常登录
□ 在 Company 中能看到你的公司信息
□ 银行账户已创建且账号正确
□ 测试邮件能发送成功且你能收到
□ 能够创建一个客户（Customer → New → 填基本信息 → Save）
□ 能够创建一个物料（Item → New → 填基本信息和价格 → Save）
□ 打印格式预览时中文正常显示（不是方块）

如果以上全部通过，你的 ERPNext 就具备了基本运行条件。下一步按照上线清单文档，做数据导入和期初余额。

最后更新：2026-05-10 适用版本：ERPNext v16.x

完成本指南后，下一步：ERPNext上线清单_从准备到切换.md