Skip to main content

快速入门

ERPNext 是一个 100% 开源的 ERP,基于 Python 和 Node 开发。它功能全面,包含会计、人力资源、制造、网站、电商、CRM、资产管理、客服工作台等全面的功能。它是 SAP 的开源替代品,全球已经有超过 5,000 家企业客户使用。

准备

部署 Websoft9 提供的 ERPNext 之后,需完成如下的准备工作:

  1. 在云控制台获取您的 服务器公网IP地址
  2. 在云控制台安全组中,确保 Inbound(入)规则 下的 TCP:80 端口已经开启
  3. 在服务器中查看 ERPNext 的 默认账号和密码
  4. 若想用域名访问 ERPNext 域名五步设置 过程

ERPNext 初始化向导

详细步骤

  1. 使用本地电脑 Chrome 或 Firefox 浏览器访问网址:http://域名 或 http://服务器公网IP, 进入初始化页面 erpnext安装登录

  2. 输入账号密码(不知道账号密码?),选择语言, 进入下一步 erpnext安装

  3. 根据安装向导依次完成后续步骤

  4. 安装完成之后,ERPNext 会弹出如下界面 erpnext后台

    可能会出现安装错误提示,此时需要反复安装: erpnext 向导安装报错

  5. ERPNext 顶部菜单中提供了搜索框,用于快速检索并进入 ERPNext 所有的功能 erpnext 快速检索

  6. 通过检索功能,进入【用户】设置,可以管理当前系统下所有账号 erpnext 用户管理

需要了解更多 ERPNext 的使用,请参考官方文档:ERPNext Documentation

出现问题?

若碰到问题,请第一时刻联系 技术支持。也可以先参考下面列出的问题定位或 FAQ 尝试快速解决问题:

ERPNext 服务启动失败?

请确认hostname是否包含字符串 ".",例如 erpnext12.14.0 对于 ERPNext 来说是一个不合规的 hostname

你可以使用下列命令来修改hostname:

hostnamectl set-hostname erpnext

ERPNext 使用入门

下面以 ERPNext 构建企业ERP 作为一个任务,帮助用户快速入门:

ERPNext 常用操作

配置 SMTP

  1. 在邮箱管理控制台获取 SMTP 相关参数

  2. 登录 ERPNext控制台,在【设置】>【电子邮件域名】填写SMTP参数 ERPNext SMTP

  3. 点击【保存】后,系统后进行一个 SMTP 初步验证,验证通过才能保存成功

域名额外配置(修改 URL)

域名五步设置 完成后,需设置 ERPNext 的 SITE_URL:

  1. 连接服务器,修改 ERPNext 容器环境变量文件:/data/wwwroot/erpnext/.env

    ...
    APP_SITE_URL=your domain
    APP_SITE_NAME=`your domain`
    ...
  1. 重启 ERPNext
    docker-compose up -d 

重置密码

常用的 ERPNext 重置密码相关的操作主要有修改密码和找回密码两种类型:

修改密码

  1. 登录 ERPNext后台,依次打开:【设置】>【个人设置】,找到修改密码项 ERPNext 修改密码

  2. 直接设置新密码,保存后生效

找回密码

如果用户忘记了 ERPNext 密码,可以通过如下的命令直接设置一个新密码:

sudo -H -u erpnext bash -c "cd /data/wwwroot/frappe-bench && export GIT_PYTHON_REFRESH=quiet && /usr/local/bin/bench set-admin-password newpassword"

ERPNext 参数

ERPNext 应用中包含 Nginx, Redis, MariaDB, Docker 等组件,可通过 通用参数表 查看路径、服务、端口等参数。

通过运行docker ps,可以查看到 ERPNext 运行时所有的 Container:

CONTAINER ID   IMAGE                        COMMAND                  CREATED          STATUS                    PORTS                                       NAMES
593c04bd4c02 phpmyadmin:latest "/docker-entrypoint.…" 42 minutes ago Up 42 minutes 0.0.0.0:9090->80/tcp, :::9090->80/tcp phpmyadmin
20e2ac33e35b redis:6.2-alpine "docker-entrypoint.s…" 43 minutes ago Up 43 minutes 6379/tcp erpnext-redis
dea90210633b frappe/erpnext-worker:v14 "bench worker --queu…" 43 minutes ago Up 43 minutes erpnext-queue-default
ef18b6e52994 frappe/erpnext-worker:v14 "bench worker --queu…" 43 minutes ago Up 42 minutes erpnext-queue-long
b4a168ab4534 frappe/erpnext-nginx:v14 "/docker-entrypoint.…" 43 minutes ago Up 42 minutes 0.0.0.0:9001->8080/tcp, :::9001->8080/tcp erpnext-frontend
c7950ea7a76b frappe/erpnext-worker:v14 "bench schedule" 43 minutes ago Up 43 minutes erpnext-scheduler
eba636cdaf31 mariadb:10.6 "docker-entrypoint.s…" 43 minutes ago Up 42 minutes (healthy) 0.0.0.0:3306->3306/tcp, :::3306->3306/tcp erpnext-db
7818fdaa4e72 frappe/frappe-socketio:v14 "docker-entrypoint.s…" 43 minutes ago Up 42 minutes erpnext-websocket
971999ec36d3 frappe/erpnext-worker:v14 "/home/frappe/frappe…" 43 minutes ago Up 43 minutes erpnext
ae93cdf7bb21 frappe/erpnext-worker:v14 "bench worker --queu…" 43 minutes ago Up 42 minutes erpnext-queue-short

erpnext 为项目主容器

路径

ERPNext 安装目录:  /data/apps/erpnext
ERPNext 站点目录:  /data/apps/erpnext/data/sites
ERPNext 数据库配置文件: /data/apps/erpnext/.env

端口

无特殊端口

版本

cat /data/apps/erpnext/.env |grep  "APP_VERSION" |awk -F"=" '{print $2}'

服务

sudo docker start | stop | restart | stats erpnext
sudo docker start | stop | restart | stats erpnext-db
sudo docker start | stop | restart | stats erpnext-scheduler
sudo docker start | stop | restart | stats erpnext-frontend
sudo docker start | stop | restart | stats erpnext-websocket
sudo docker start | stop | restart | stats erpnext-redis
sudo docker start | stop | restart | stats erpnext-queue-default
sudo docker start | stop | restart | stats erpnext-queue-long
sudo docker start | stop | restart | stats erpnext-queue-short
sudo docker start | stop | restart | stats phpmyadmin

命令行

CLI to manage Multi-tenant deployments for Frappe apps

API

参考: ERPNext API