> 全程没有图形界面、没有鼠标点击，靠命令行把一台虚拟机变成能跑业务的服务器。
> 本文记录完整过程，含踩坑与复盘。

---

## 一、先说说这个标题里的"一小时"

很多人看到"一小时做了套 ERP"，第一反应是"标题党"。

所以先把时间账摊开讲清楚。

从文件系统的时间戳上看，整个过程的真实分布是这样的：

| 阶段 | 耗时 | 说明 |
|---|---|---|
| 环境勘察 + 架构选型 | 约 40 分钟 | 摸清机器家底、调研业界产品、定技术方案 |
| 写代码 | 6 分 34 秒 | 40 个文件、约 4000 行，从第一个文件到最后一个 |
| 上传 + 部署 + 验证 | 2 分 16 秒 | 传到服务器、装依赖、起服务、开防火墙 |

**所以准确的说法是：一小时左右完成从环境准备到系统上线。**

写代码那 6 分半为什么这么快？后面会讲，是因为**架构对了**。

---

## 二、起点：一台刚装好的虚拟机

手头有的东西很简单：

- 一台 VMware 虚拟机，装了 **openEuler 24.03 LTS-SP4**（华为开源的企业级 Linux）
- 内核 6.6.0
- 分配了 8 个 vCPU、6GB 内存、60GB 硬盘
- 桥接网络，虚拟机和物理机在同一个网段
- 只装了 524 个包（最小化安装，连开发工具都没有）

要干的事也简单：**在这台机器上跑一套 ERP 系统。**

但先别急着写代码。第一步应该是**摸清家底**。

---

## 三、第一步：勘察，别急着动手

我做的是先登上去，把机器的真实情况摸清楚：

```bash
# 主机与系统
hostname
cat /etc/openEuler-release
uname -r
uptime

# 网络
ip -4 -br addr show scope global
ip route | grep default

# 资源
nproc              # CPU 核心数
free -h            # 内存
df -h /            # 磁盘

# CPU 拓扑（这个后面踩了坑）
lscpu | grep -Ei 'socket|core|thread|model name|^CPU\(s\)'
```

拿到的事实：

```text
系统：openEuler release 24.03 (LTS-SP4)
内核：6.6.0-159.4.3.154.oe2403sp4.x86_64
网卡：ens160，局域网静态 IP（与物理机同网段）
网关：局域网网关
CPU ：8 逻辑核（Intel i7-10875H 透传）
内存：5.3 GB 可用
磁盘：根分区 35 GB，已用 8%
软件包：524 个，无开发工具链
```

**为什么这一步不能省？**

因为后面所有的技术决策都建立在上面这些事实上。比如：

- 内存只有 5.3GB → 数据库选型要谨慎，不能上重型中间件
- 是最小化安装，没有 pip / gcc → 得提前想好装依赖的方案
- 磁盘 35GB 够用 → 不用担心空间

**家底清楚了，方案才敢定。**

---

## 四、关键决策：别把 ERPNext 那一套照搬过来

说到开源 ERP，业界做得好的有这么几款：

| 产品 | 技术栈 |
|---|---|
| **Odoo** | Python + PostgreSQL + 自研 OWL 前端 |
| **ERPNext** | Python(Frappe) + MariaDB + Redis + Node.js(Socket.IO) + Nginx + Gunicorn |
| **Dolibarr** | PHP + MySQL（经典 LAMP 架构） |
| **Metasfresh** | Java Spring + PostgreSQL |
| **Apache OFBiz** | Java 全家桶 |

我最终参考的是 **ERPNext** 的架构风格——它是这里面最现代、最适合在 Linux 上部署的。

**但是，我决定不照搬它的技术栈。**

ERPNext 为什么需要 Redis、Node.js、Nginx、MariaDB 这一大堆？

因为它要扛的是**多租户 SaaS 级别的高并发**：

| 组件 | ERPNext 的用途 | 我这套需要吗 |
|---|---|---|
| MariaDB | 存业务数据 | SQLite 够用 |
| Redis | 缓存 + 异步任务队列 | 无异步任务需求 |
| Node.js Socket.IO | 实时消息推送 | 无实时协作需求 |
| Nginx | 反向代理 + 静态资源 | 直连够用 |

**结论：那四个组件，一个都不装。**

不是偷工减料，而是这套业务场景本来就用不上。**少一个组件，就少一份运维负担、少一个故障点、少一份安全隐患。**

最终定下来的架构是这样的：

```text
浏览器（物理机 / 手机）
        │ HTTP
        ▼
┌─────────────────────────────────┐
│  openEuler 24.03 LTS-SP4        │
│                                 │
│  systemd ──> Gunicorn(4 worker) │
│                  │              │
│                  ▼              │
│              Flask 应用         │
│              ├─ 9 个业务模块    │
│              └─ SQLAlchemy ORM  │
│                  │              │
│                  ▼              │
│              SQLite             │
└─────────────────────────────────┘
```

### 技术选型清单

| 层次 | 技术 | 版本 |
|---|---|---|
| 操作系统 | openEuler | 24.03 LTS-SP4 |
| 运行时 | Python | 3.11.6（系统自带） |
| Web 框架 | Flask | 3.1.3 |
| WSGI 服务器 | Gunicorn | 26.2.0 |
| ORM | SQLAlchemy | 2.1.4 |
| 数据库 | SQLite 3 | 内置 |
| 模板引擎 | Jinja2 | 3.1.6 |
| 进程守护 | systemd | 系统自带 |
| 前端 | Bootstrap 5.3 + Chart.js 4.4 | CDN |

**注意看这一列的"来源"——Python、SQLite、systemd 全是系统自带的，真正需要 pip 装的只有 11 个包。**

---

## 五、写代码：6 分半，40 个文件

这部分是整个项目里最"爽"的环节，因为架构定对了。

### 5.1 项目结构

```text
mini-erp/
├── run.py                    # 启动入口
├── config.py                 # 配置（含数据库连接串）
├── seed.py                   # 演示数据初始化
├── requirements.txt          # 依赖清单
├── deploy.sh                 # 一键部署脚本
├── README.md
├── app/
│   ├── __init__.py           # 应用工厂
│   ├── models.py             # 11 张表的数据模型
│   ├── views/                # 9 个业务模块
│   │   ├── dashboard.py
│   │   ├── customer.py
│   │   ├── supplier.py
│   │   ├── product.py
│   │   ├── stock.py
│   │   ├── sales.py
│   │   ├── purchase.py
│   │   ├── finance.py
│   │   └── system.py
│   ├── templates/            # 21 个页面模板
│   └── static/               # CSS / JS
└── instance/
    └── erp.db                # 数据库文件
```

### 5.2 为什么能写得这么快？

**核心原因：架构的"复用率"极高。**

三个设计决定，直接决定了速度：

**① 应用工厂模式（`create_app()`）**

所有模块通过统一入口注册，加一个模块只需要两行代码：

```python
from app.views import dashboard, customer, supplier  # ...
app.register_blueprint(dashboard.bp)
app.register_blueprint(customer.bp)
```

**② Blueprint 分模块路由**

9 个业务模块结构完全一致，写第 1 个和第 9 个的成本几乎没有差别：

```python
bp = Blueprint('customer', __name__, url_prefix='/customer')

@bp.route('/')
def index():
    # 列表页：查询 + 分页
    ...

@bp.route('/create', methods=['GET', 'POST'])
def create():
    # 新增：表单校验 + 落库
    ...
```

**③ Jinja2 模板继承**

21 个页面共用一套 `base.html` 骨架，每个子页面只写自己的内容块：

```html
{% extends "base.html" %}
{% block content %}
  
{% endblock %}
```

**这三个设计一确定，剩下的就是"填空"——快是有原因的，不是因为写得糙。**

### 5.3 代码规模统计

| 类型 | 数量 | 行数 |
|---|---|---|
| Python 文件 | 15 个 | 约 1,340 行 |
| HTML 模板 | 19 个 | 约 1,650 行 |
| CSS 样式 | 1 个 | 315 行 |
| 文档 / 脚本 | 5 个 | 约 740 行 |
| **合计** | **40 个文件** | **约 4,041 行** |

其中业务模块的分布很均匀：

```text
dashboard.py    78 行
customer.py     78 行
supplier.py     75 行
product.py      76 行
stock.py        58 行
sales.py       101 行
purchase.py    111 行
finance.py      94 行
system.py       68 行
```

`purchase.py` 最"重"（111 行），因为采购收货要做自动入库和自动记账，逻辑最复杂。

---

## 六、数据模型：11 张表

ERP 的核心是数据关系，这部分想清楚了，业务逻辑就是水到渠成。

| 表名 | 说明 | 关键字段 |
|---|---|---|
| customers | 客户 | code, name, contact, phone, credit_limit |
| suppliers | 供应商 | code, name, contact, phone |
| products | 商品 | code, name, cost_price, sale_price, stock_qty, safety_stock |
| stock_logs | 库存流水 | product_id, change_qty, before_qty, after_qty, log_type |
| sales_orders | 销售订单 | order_no, customer_id, total_amount, status |
| sales_order_items | 销售明细 | order_id, product_id, qty, unit_price |
| purchase_orders | 采购订单 | order_no, supplier_id, total_amount, status |
| purchase_order_items | 采购明细 | order_id, product_id, qty, unit_price |
| finance_records | 财务流水 | record_no, record_type, amount, related_order |
| users | 系统用户 | username, password_hash, role, status |
| system_settings | 系统配置 | key, value, description |

### 表间关系

```text
customers ──┐
            ├──> sales_orders ──> sales_order_items ──> products
            │                                              │
suppliers ──┴──> purchase_orders ──> purchase_order_items ─┘
                                                           │
                                                           ▼
                                                     stock_logs
                                                           │
                          finance_records <────────────────┘
```

**注意 `users` 表里存的是 `password_hash`，不是明文密码。** 这一点在设计阶段就要定死，后面再改成本就高了。

---

## 七、两个"有意思"的业务联动

标准 CRUD 只是骨架，真正体现 ERP 思维的是**业务联动**。我做了两处：

### 联动一：采购收货 → 自动入库 + 自动记账

采购单状态改成"已收货"时，系统自动做两件事：

```python
if new_status == 'received':
    # 1. 为每个商品增加库存
    for item in order.items:
        product = Product.query.get(item.product_id)
        before = product.stock_qty
        product.stock_qty += item.qty
        # 记一条库存流水
        db.session.add(StockLog(
            product_id=product.id,
            change_qty=item.qty,
            before_qty=before,
            after_qty=product.stock_qty,
            log_type='in',
            reason=f'采购入库 {order.order_no}'
        ))

    # 2. 生成一条财务支出
    db.session.add(FinanceRecord(
        record_no=gen_no('EXP'),
        record_type='expense',
        amount=order.total_amount,
        related_order=order.order_no,
        remark=f'采购付款 {order.order_no}'
    ))
```

### 联动二：销售完成 → 自动记账

销售单状态改成"已完成"时，自动生成收入流水。

**这两处的价值在于：让系统"像一个真正的 ERP"，而不是一个能增删改查的电子表格。**

---

## 八、部署：2 分 16 秒

这部分比写代码还快，因为前面把环境摸清楚了。

### 8.1 上传代码

```bash
# 从本地传到服务器
pscp -r mini-erp <用户名>@<服务器IP>:/opt/
```

### 8.2 装依赖

```bash
pip3 install -r requirements.txt
```

**这里踩了一个坑：** 默认的 pip 源返回 403 Forbidden。诊断后发现不是网络问题，是源本身的问题。换成国内镜像源就通了。

因为 Python、SQLite 是系统自带的，**实际只装了 11 个包**：

```text
Flask 3.1.3          Flask-SQLAlchemy 3.1.1   gunicorn 26.2.0
SQLAlchemy 2.1.4     Jinja2 3.1.6             Werkzeug 3.1.9
blinker 1.9.0        click 8.5.0              itsdangerous 2.2.0
MarkupSafe 3.0.4     typing_extensions 4.16.0
```

### 8.3 配置 systemd 服务

这是让服务"活起来"的关键一步：

```ini
[Unit]
Description=MiniERP - 轻量级企业资源计划系统
After=network.target

[Service]
Type=simple
User=<专用低权限用户>
WorkingDirectory=/opt/mini-erp
Environment="FLASK_ENV=production"
Environment="PORT=8000"
ExecStart=/usr/bin/python3 -m gunicorn -w 4 -b 0.0.0.0:8000 run:app
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```

```bash
systemctl daemon-reload
systemctl enable minierp     # 开机自启
systemctl start minierp      # 启动
```

**`Restart=always` + `RestartSec=5` 意味着：进程万一崩了，5 秒内自动拉起来。**

### 8.4 开防火墙

```bash
firewall-cmd --permanent --add-port=8000/tcp
firewall-cmd --reload
```

### 8.5 初始化演示数据

```bash
python3 seed.py
```

生成了：8 家客户、5 家供应商、12 种商品、14 张销售单、8 张采购单、40 条财务流水。

---

## 九、验证：不是"能打开"，是"能写能读"

部署完最后一步，一定要做**端到端验证**，而不是只看看首页能不能打开。

### 9.1 服务层验证

```bash
systemctl is-enabled minierp   # → enabled
systemctl is-active minierp    # → active
ss -lntp | grep 8000           # → LISTEN 0.0.0.0:8000
```

进程树：

```text
1 master + 4 worker，全部在跑
master 内存 36MB，每个 worker 约 60MB
```

### 9.2 业务层验证

从物理机浏览器访问 9 个模块，全部返回 HTTP 200：

```text
仪表盘   ✅  客户    ✅  供应商  ✅
商品     ✅  库存    ✅  销售    ✅
采购     ✅  财务    ✅  系统    ✅
```

### 9.3 数据层验证（最关键）

**做一个真实的写入测试**：从物理机提交一条新客户记录，然后去数据库里查。

```text
提交前：customers 表 = 8 行
提交后：customers 表 = 9 行  ← 新记录在里面，中文名正常存储
清理后：customers 表 = 8 行
```

**这一步证明的不是"页面能打开"，而是"数据真的能进能出、能写库能读库、中文不乱码"。**

---

## 十、踩过的坑

真实项目不可能一帆风顺，几个印象深刻的：

### 坑 1：CPU 拓扑不对

**要求**：1 路 × 4 核 × 2 线程
**实际**：2 路 × 4 核 × 1 线程

总数都是 8 个 vCPU，但形态不同。原因是虚拟机的配置参数没被正确识别。

**教训**：虚拟化环境下，`nproc` 只告诉你有几个核，`lscpu` 才告诉你拓扑结构。要用后者验收。

### 坑 2：pip 源 403

`ERROR: No matching distribution found for flask`

第一反应是网络问题，ping 通了；第二反应是证书问题，也不是。最后发现是源本身返回 403。**换个镜像源解决。**

**教训**：报错信息要看全，不要凭经验猜。

### 坑 3：数据库文件路径写错

SQLite 报"无法打开数据库文件"。查了半天，发现是配置里路径拼接写错了——多套了一层 `dirname`。

**教训**：路径问题永远是部署阶段的高频坑，配置文件里的每一个 `os.path.join` 都值得看一眼。

### 坑 4：命令行中文乱码

通过 SSH 工具执行远程命令时，中文输出变成乱码。不影响 Web 界面，但看日志时很痛苦。

**教训**：跨平台传输中文，编码问题绕不开。

---

## 十一、复盘：为什么能这么快

回过头看，快的原因可以归成四条：

### ① 环境准备得早

虚拟机提前装好、网络配通、SSH 打通、工具就位。**部署阶段没有一分一秒浪费在环境上。**

很多人做项目，一半时间花在"环境怎么又不对了"。这部分时间提前挤掉了。

### ② 架构选得对

Flask 的应用工厂 + Blueprint + 模板继承，这套组合的**边际成本极低**。

第 1 个模块要写 78 行，第 9 个模块还是 78 行。如果架构没设计好，第 9 个可能要写 200 行。

### ③ 敢于做减法

**Redis、Node.js、Nginx、MariaDB 一个没装。**

如果照搬 ERPNext 的完整技术栈，光装和配这些中间件就得一两个小时，而且会引入一堆新的故障点。

**"能不上就不上"是一种能力。**

### ④ 先想清楚再动手

数据模型、业务联动这些"想"的部分花了时间，但正因为想清楚了，写的时候不用返工。

**想 40 分钟，写 6 分钟——这个比例是健康的。**

---

## 十二、这套系统能上生产吗？

**说实话：不能。**

当前的状态是"演示 / 内部试用"级别。离生产环境还有明确差距：

| 问题 | 风险 |
|---|---|
| 用 root 跑应用 | 🔴 应用被攻破 = 整机沦陷 |
| 密钥是默认值 | 🔴 会话可被伪造 |
| 没有 HTTPS | 🔴 数据明文传输 |
| SQLite 无账号体系 | 🟠 靠文件权限 |
| SQLite 并发弱 | 🟠 多人同时写会排队 |
| 无反向代理 | 🟠 缺 HTTPS 终结、限流 |
| 无自动备份 | 🟠 文件损坏数据全丢 |

### 上生产必须做的（P0）

```bash
# 1. 建专用低权限用户，别用 root
useradd -r -s /sbin/nologin minierp
chown -R minierp:minierp /opt/mini-erp

# 2. 生成随机密钥替换默认值
python3 -c "import secrets; print(secrets.token_hex(32))"

# 3. 上 Nginx + HTTPS
dnf install nginx

# 4. 改掉所有默认密码
```

### 换数据库只要一行

代码里早就预留了切换点，迁到 MySQL 不需要改一行代码：

```bash
export DATABASE_URL="mysql+pymysql://用户:密码@localhost/erpdb"
systemctl restart minierp
```

---

## 十三、写在最后

一小时做出这套东西，**不是因为写得快，而是因为路走对了**。

真正省时间的三个决定：

1. **先勘察再动手** —— 摸清 5.3GB 内存、最小化安装这些事实，才敢做"不上 Redis"的决定
2. **先做减法** —— 砍掉用不上的中间件，比装完再优化省事得多
3. **想清楚架构再写** —— 应用工厂 + Blueprint 让 9 个模块变成填空题

**技术选型的本质，是知道什么"不需要"。**
![image.png](https://developer.qcloudimg.com/http-save/yehe-12805940/615463d6edd660ef9822c8bc2be6ddaa.png)

全程没有图形界面、没有鼠标点击，靠命令行把一台虚拟机变成能跑业务的服务器。 本文记录完整过程，含踩坑与复盘。

一小时，我在 openEuler 上从零搭了一套 ERP 系统

后端

架构设计

新闻资讯

一小时从零部署ERP系统：基于openEuler 24.03最小化安装，用Flask+SQLite仅4000行代码完成9大业务模块。通过架构精简（砍掉Redis/Nginx等组件）、应用工厂模式和Blueprint复用，实现6分半写完代码、2分16秒完成部署。全程命令行操作，含完整踩坑记录和架构选型分析，适合轻量级企业资源管理场景。

文件系统

代码解释

PostgreSQL

虚拟机

数据库

服务器

虚拟化

中间件

防火墙

MariaDB

Python

路由

SQLite

Redis

Linux

MySQL

Nginx

SaaS

2026上云采购 | AI焕新·智启新局

workbuddy

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

一小时从零部署ERP系统：基于openEuler 24.03最小化安装，用Flask+SQLite仅4000行代码完成9大业务模块。通过架构精简（砍掉Redis/Nginx等组件）、应用工厂模式和Blueprint复用，实现6分半写完代码、2分16秒完成部署。全程命令行操作，含完整踩坑记录和架构选型分析，适合轻量级企业...

一小时，我在 openEuler 上从零搭了一套 ERP 系统-腾讯云开发者社区-腾讯云

一小时，我在 openEuler 上从零搭了一套 ERP 系统

一小时，我在 openEuler 上从零搭了一套 ERP 系统

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐