mirror of
https://github.com/SeanChang/xuanyuan_docker_proxy.git
synced 2026-10-06 12:34:04 +08:00
208 lines
8.8 KiB
Markdown
208 lines
8.8 KiB
Markdown
# 10 分钟用 Docker 跑起 Odoo！中小企业免费 ERP 部署实战
|
||
|
||
|
||
|
||
*分类: Docker部署教程 | 标签: Docker,Odoo,ERP,PostgreSQL | 发布时间: 2026-06-08 03:47:21*
|
||
|
||
> 不少中小企业都有这样的困扰：销售靠Excel记账、库存人工盘点、财务对账耗时费力、客户信息零散混乱，多个办公系统切换使用，数据不通、效率低下。今天给大家分享一套零成本、一体化的解决方案——Odoo开源ERP系统。全程采用Docker部署，无需复杂环境配置，10分钟即可搭建完成，适配国内服务器，稳定高速、无冗余操作。
|
||
|
||
不少中小企业都有这样的困扰：销售靠Excel记账、库存人工盘点、财务对账耗时费力、客户信息零散混乱，多个办公系统切换使用，数据不通、效率低下。今天给大家分享一套零成本、一体化的解决方案——Odoo开源ERP系统。全程采用Docker部署，无需复杂环境配置，10分钟即可搭建完成，适配国内服务器，稳定高速、无冗余操作。
|
||
|
||
## 一、为什么选Odoo？中小企业专属数字化工具
|
||
|
||
Odoo是全球主流的开源企业管理系统，前身是OpenERP，基于Python开发，支持免费商用。最大的优势是**模块化、全集成、无版权费用**，完美适配中小微企业日常经营需求，彻底告别多系统杂乱办公的问题。
|
||
|
||
核心常用功能全覆盖：
|
||
|
||
- **销售管理**：一键生成报价单、销售订单，全程跟进发货、回款流程
|
||
|
||
- **客户管理(CRM)**：统一归档客户信息、跟进商机线索，避免客户流失
|
||
|
||
- **库存仓储**：实时同步库存数据，支持多仓库管理、出入库记录溯源
|
||
|
||
- **财务会计**：自动对账、开票管理、流水记录，简化财务核算工作
|
||
|
||
- **人事行政**：员工档案、考勤请假、招聘流程一体化管理
|
||
|
||
- **电商建站**：快速搭建企业官网、线上店铺，订单自动同步后台
|
||
|
||
相较于付费ERP系统，Odoo基础功能永久免费、不限用户数，小到初创团队、大到中小型工厂都能直接使用。国内可通过轩辕镜像快速拉取Odoo镜像，速度远超官方源，配套中文文档，部署更省心：[Odoo ERP 镜像下载](https://xuanyuan.cloud/zh/r/library/odoo)
|
||
|
||
## 二、前置准备：Docker环境一键搞定
|
||
本次采用 Docker 容器化方式部署 Odoo，隔离环境、部署简单、迁移方便，下面分系统完成 Docker 安装配置。
|
||
|
||
### Linux系统（含国产系统）一键安装
|
||
Ubuntu、CentOS、欧拉、银河麒麟、统信UOS 等主流 Linux 及国产操作系统，可直接执行一键脚本，自动安装 Docker、Docker Compose，并配置国内镜像加速，彻底解决拉取镜像慢的问题。
|
||
打开终端，执行以下命令：
|
||
```bash
|
||
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
|
||
```
|
||
|
||
|
||
备用地址：
|
||
|
||
```bash
|
||
bash <(wget -qO- https://get.xuanyuan.me/docker.sh)
|
||
```
|
||
### Windows / Mac 用户
|
||
Windows 和 Mac 桌面系统，直接使用官方 Docker Desktop 即可，图形化操作简单易上手。
|
||
👉 [Docker Desktop官方下载](https://www.docker.com/get-started/)
|
||
安装完成后启动软件，桌面状态栏出现鲸鱼图标，代表 Docker 正常运行。
|
||
|
||
### 验证安装
|
||
打开终端（Linux）或 PowerShell（Windows），执行命令检查 Docker 状态：
|
||
```bash
|
||
docker version
|
||
```
|
||
输出 Client、Server 版本信息，即代表环境准备完成。
|
||
|
||
## 三、Docker 部署 Odoo 19 及权限问题排错
|
||
|
||
### 1. 创建本地挂载目录并授权
|
||
我们将宿主机 `/data/odoo` 目录挂载到容器内 `/var/lib/odoo`，首先手动创建目录，并开放读写权限，解决权限拒绝问题：
|
||
```bash
|
||
# 递归创建目录
|
||
mkdir -p /data/odoo
|
||
|
||
# 赋予目录完整读写权限
|
||
chmod -R 777 /data/odoo
|
||
```
|
||
|
||
### 2. 启动Odoo 19容器
|
||
执行 `docker run` 命令拉取轩辕镜像并启动容器，命令中配置了网络、端口、数据库连接、自启动等参数，直接复制运行即可：
|
||
```bash
|
||
docker run -d \
|
||
--name odoo19 \
|
||
--network odoo-net \
|
||
-p 8069:8069 \
|
||
-e HOST=odoo-db \
|
||
-e USER=odoo \
|
||
-e PASSWORD=odoo123 \
|
||
-v /data/odoo:/var/lib/odoo \
|
||
--restart unless-stopped \
|
||
docker.xuanyuan.run/library/odoo:19.0-20260528
|
||
```
|
||
|
||
### 3. 查看运行日志，验证是否正常启动
|
||
通过日志排查运行状态，不再出现权限报错即为正常：
|
||
```bash
|
||
docker logs -f odoo19
|
||
```
|
||
**正常日志特征**：
|
||
出现 `HTTP service (werkzeug) running on`、`database: odoo@odoo-db:5432` 相关内容。
|
||
**异常判断**：
|
||
如果日志中包含 `PermissionError: [Errno 13]`，说明目录权限依旧异常，重新执行第一步授权命令即可。
|
||
|
||
很多朋友在挂载本地目录运行 Odoo 容器后，会遇到 **500 服务错误**，根源并非 Odoo 程序本身，而是**宿主机挂载目录权限不足**，容器内 Odoo 进程无法创建 `sessions` 会话目录，进而触发权限报错。
|
||
|
||
下面一步步完整部署并修复问题。
|
||
|
||
### 停止并清理旧容器
|
||
如果之前已经启动过异常容器，先停止并删除，避免冲突：
|
||
```bash
|
||
# 停止Odoo容器
|
||
docker stop odoo19
|
||
|
||
# 删除旧容器
|
||
docker rm odoo19
|
||
```
|
||
|
||
## 四、Odoo数据库初始化配置
|
||
容器启动成功后，打开浏览器访问地址：`http://服务器IP:8069`，进入 Odoo 数据库初始化页面。
|
||
|
||
### 1. 页面参数说明与填写
|
||
页面会自动生成**数据库管理主密码（Master Password）**，该密码用于后续数据库创建、备份、删除、恢复，请务必妥善保存。
|
||
本次示例生成密码：`hs49-y5aj-qr7t`（你本地会随机生成，以页面显示为准）。
|
||
|
||
|
||
|
||
各参数填写参考：
|
||
1. **Master Password**：使用页面自动生成的密码（后期可修改）
|
||
2. **Database Name**：自定义数据库名，例如 `odoo19`
|
||
3. **Email**：管理员登录账号（如 `admin@example.com`）
|
||
4. **Password**：设置后台管理员登录密码
|
||
5. **Phone Number**：选填，可留空
|
||
6. **Language**：选择 `Chinese, Simplified / 简体中文`
|
||
7. **Country**：选择 `China`
|
||
8. **Demo Data**：测试体验可勾选，正式生产环境建议取消勾选
|
||
|
||
填写完成后点击 **Create database**，首次初始化耗时 1~5 分钟，耐心等待即可。
|
||
|
||
> 小提示：重复点击创建按钮会提示数据库已存在，属于正常现象，点击蓝色 odoo19 继续进入页面即可。
|
||
|
||
### 2. 登录后台
|
||
数据库创建完成后，直接点击页面上的数据库名称，或访问后台地址：
|
||
```
|
||
http://服务器IP:8069/web
|
||
```
|
||
|
||
|
||
登录注意区分两个密码：
|
||
- **管理员登录**：使用刚才设置的 `Email + 自定义密码`
|
||
- **数据库管理**（建库/删库/备份）：使用页面生成的 `Master Password`
|
||
|
||
### 3. 数据库状态核查（可选）
|
||
如需确认数据库是否正常创建，可执行以下命令进入数据库查看：
|
||
```bash
|
||
docker exec -it odoo-db psql -U odoo -l
|
||
```
|
||
列表中能看到你创建的数据库名（如 `odoo19`），代表整个部署流程全部完成。
|
||
|
||
|
||
|
||
此时，Odoo 就正常运行进入了，你可以根据需要添加相关系统模块。
|
||
|
||
|
||
|
||
## 五、总结
|
||
1. Odoo 采用 Docker 容器部署是最高效的方式，依托轩辕镜像可快速拉取、稳定运行；
|
||
2. 部署 Odoo 最常见的 500 报错，90% 都是**本地挂载目录权限不足**导致，给目录开放读写权限即可彻底解决；
|
||
3. 部署完成后分清「管理员登录密码」和「数据库主密码」，避免后续操作混淆；
|
||
4. 正式上线前建议关闭演示数据，保证系统纯净，满足企业正式使用需求。
|
||
|
||
按照本文步骤操作，即可在 Linux、国产服务器上快速搭建一套可用的 Odoo 19 企业ERP系统。
|
||
|
||
参考文档：[Odoo ERP 中文简介及镜像下载](https://xuanyuan.cloud/zh/r/library/odoo)
|
||
|
||
附件：
|
||
|
||
```bash
|
||
version: "3.8"
|
||
|
||
services:
|
||
db:
|
||
image: docker.xuanyuan.run/postgres:17
|
||
container_name: odoo-db
|
||
restart: unless-stopped
|
||
environment:
|
||
POSTGRES_USER: odoo
|
||
POSTGRES_PASSWORD: odoo123
|
||
POSTGRES_DB: postgres
|
||
volumes:
|
||
- /data/postgres:/var/lib/postgresql/data
|
||
networks:
|
||
- odoo-net
|
||
|
||
odoo:
|
||
image: docker.xuanyuan.run/library/odoo:19.0-20260528
|
||
container_name: odoo19
|
||
restart: unless-stopped
|
||
depends_on:
|
||
- db
|
||
ports:
|
||
- "8069:8069"
|
||
environment:
|
||
HOST: db
|
||
USER: odoo
|
||
PASSWORD: odoo123
|
||
volumes:
|
||
- /data/odoo:/var/lib/odoo
|
||
networks:
|
||
- odoo-net
|
||
|
||
networks:
|
||
odoo-net:
|
||
driver: bridge
|
||
```
|
||
|