三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

群晖Docker部署Odoo 13：低成本构建企业级ERP系统

发布时间：2026/8/16 22:00:38 三亩地 编程学习日记
群晖Docker部署Odoo 13：低成本构建企业级ERP系统

1. 项目概述：为什么要在群晖Docker里部署Odoo 13？

如果你手头有一台群晖NAS，并且正在为小团队或初创公司寻找一个成本可控、功能全面又易于管理的企业资源计划（ERP）系统，那么“在群晖Docker里跑Odoo 13”这个方案，很可能就是你一直在找的答案。这听起来有点技术门槛，但实际操作下来，你会发现它远比想象中简单——基本上就是“点点鼠标”就能完成部署。Odoo本身是一个开源、模块化、功能强大的企业管理套件，从销售、库存、采购到财务、人力资源，几乎覆盖了企业运营的方方面面。而Odoo 13作为一个长期支持版本，功能成熟稳定，社区资源丰富。

把Odoo 13放进群晖的Docker容器里运行，最大的好处就是“隔离”和“便捷”。你不用在NAS的主系统上安装一堆复杂的依赖，不会污染系统环境；通过Docker，你可以像安装一个APP一样，快速拉起一个包含Odoo及其所有运行环境的独立“沙箱”。更新、备份、迁移都变得异常简单。更重要的是，对于很多预算有限、技术资源不充裕的小微企业或个人工作室来说，这几乎是一个“零成本”的解决方案——硬件是你已有的群晖NAS，软件是开源的Odoo，部署工具是群晖自带的Docker套件。接下来，我就带你一步步拆解这个方案，从设计思路到实操部署，再到避坑指南，让你能真正把这个免费的企业级ERP用起来。

2. 整体方案设计与核心组件解析

2.1 为什么选择“群晖 + Docker + Odoo 13”这个组合？

这个组合的吸引力在于它巧妙地平衡了能力、成本和易用性。我们逐一来看每个环节的考量。

群晖NAS作为硬件平台：对于许多小型办公室或家庭办公室，一台群晖NAS往往是现成的数据存储和共享中心。它7x24小时开机、低功耗、网络连接稳定的特性，使其天然适合作为轻量级应用服务器。与其让NAS只做文件存储，不如挖掘其计算潜力来运行业务系统，实现硬件资源的复用，这是成本控制的第一步。

Docker作为部署载体：群晖的DSM操作系统提供了官方的Docker套件（现在更名为Container Manager），其图形化界面极大降低了容器技术的使用门槛。选择Docker部署Odoo，而非直接在DSM上安装，主要基于以下几点：

  1. 环境一致性：Odoo依赖于特定的Python版本、PostgreSQL数据库以及一系列系统库。Docker镜像确保了无论在谁的群晖上，Odoo的运行环境都是一模一样的，彻底避免了“在我机器上好好的”这类问题。
  2. 隔离与安全：Odoo及其数据库运行在独立的容器中，与NAS主机系统隔离。即使Odoo应用出现安全漏洞，攻击面也被限制在容器内部，不会危及NAS上存储的宝贵数据。
  3. 维护便捷性：升级Odoo版本？只需要拉取新版本的镜像，创建新容器替换旧容器即可，过程干净利落。备份？直接备份容器对应的数据卷文件夹。这种“不可变基础设施”的理念，让系统维护变得可预测且简单。

Odoo 13作为应用核心：在Odoo的多个版本中，选择13社区版，是经过深思熟虑的。Odoo 13是一个LTS（长期支持）版本，这意味着它在发布后的数年内会持续获得安全更新和错误修复，为生产环境提供了稳定性保障。相较于更老的版本（如Odoo 12），它拥有更新的用户界面和更多功能模块；相较于更新的版本（如Odoo 16, 17），它的社区模块生态更为成熟，遇到问题时更容易找到解决方案和参考资料。对于初次接触Odoo的用户，从13这个承上启下的版本入手，学习曲线相对平缓。

2.2 方案架构与数据流设计

一个典型的部署包含两个核心容器：

  1. PostgreSQL数据库容器：Odoo的所有业务数据（客户、订单、产品、账目等）都存储在这里。我们通常会为Odoo单独创建一个PostgreSQL容器，而不是使用群晖自带的数据库服务，同样是为了隔离和便于管理。
  2. Odoo 13应用容器：这是提供Web界面和处理业务逻辑的应用服务器。它需要连接到上述的PostgreSQL数据库。

它们与用户之间的关系是这样的：用户通过浏览器访问群晖NAS的IP地址和指定的端口（例如http://nas-ip:8069），请求首先到达Odoo应用容器。Odoo容器根据业务逻辑，向PostgreSQL数据库容器发起查询或更新数据的请求，然后将处理结果（生成的网页）返回给用户的浏览器。所有的数据文件（比如Odoo的附件、会话文件等）和数据库的数据文件，我们都会通过Docker的“卷”功能，映射到群晖NAS的物理硬盘目录上。这样，即使容器被删除，宝贵的数据依然安全地留在NAS硬盘里。备份时，我们只需要备份这些映射出来的目录即可。

注意：强烈建议将数据库文件和Odoo数据文件存放在不同的卷或目录下。例如，/volume1/docker/odoo13/postgresql/data存放数据库，/volume1/docker/odoo13/odoo/data存放应用数据。这为未来的数据迁移、单独备份恢复提供了灵活性。

3. 实操部署：一步步在群晖Docker中拉起Odoo 13

理论清晰后，我们进入动手环节。请确保你的群晖NAS已安装并开启了SSH功能（控制面板 > 终端机和SNMP > 启用SSH功能），同时已在套件中心安装好了“Container Manager”（Docker）。

3.1 第一步：准备存储目录与获取镜像

在群晖的File Station中，先规划好存储位置。我习惯在/volume1/docker/目录下为每个应用创建独立的文件夹。这次我们创建：

  • /volume1/docker/odoo13/postgresql/data(用于存放数据库文件)
  • /volume1/docker/odoo13/odoo/addons(用于存放自定义模块，可选但推荐)
  • /volume1/docker/odoo13/odoo/config(用于存放Odoo配置文件，可选但推荐)
  • /volume1/docker/odoo13/odoo/data(用于存放Odoo会话、附件等数据)

创建好这些空文件夹。接下来，打开Container Manager，在“注册表”中搜索镜像。

  1. 搜索“postgres”。我们选择官方镜像，标签（Tag）选择13。Odoo 13官方推荐搭配PostgreSQL 9.6以上，使用PostgreSQL 13可以保证更好的兼容性和性能。点击“下载”。
  2. 搜索“odoo”。同样选择官方镜像，标签选择13.0。点击“下载”。

等待两个镜像下载完成。这个过程取决于你的网络速度。

3.2 第二步：部署并配置PostgreSQL数据库容器

这是整个系统的基石，必须先启动。

  1. 在Container Manager的“映像”中，找到刚下载的postgres:13镜像，点击“启动”。
  2. 容器名称：起一个易懂的名字，比如odoo13-db。
  3. 启用资源限制：建议勾选，为这个容器分配一定的CPU和内存上限（例如，2核CPU，1024MB内存），避免它占用过多主机资源。
  4. 高级设置：
    • 卷：点击“添加文件夹”。选择你在File Station中创建的/volume1/docker/odoo13/postgresql/data文件夹。在“挂载路径”里填写/var/lib/postgresql/data。这一步至关重要，它将容器内的数据库存储目录持久化到了NAS的硬盘上。
    • 端口设置：通常不需要映射端口到主机，因为只有Odoo容器需要访问它。保持默认即可。
    • 环境：这是配置数据库的关键。点击“添加”，我们需要设置两个环境变量：
      • POSTGRES_USER=odoo(设置数据库超级用户名为odoo)
      • POSTGRES_PASSWORD=这里设置一个强密码(为odoo用户设置密码，务必牢记！)
      • POSTGRES_DB=postgres(可选，设置默认数据库名)
    • 网络：确保它连接在默认的“bridge”网络上即可。
  5. 点击“应用”，然后“下一步”，最后点击“完成”。容器启动后，可以在“容器”列表中看到odoo13-db正在运行。

实操心得：数据库密码是最高机密。不要使用简单密码，建议使用密码管理器生成并保存。这个密码将在下一步配置Odoo容器时用到。另外，如果你计划未来运行多个Odoo实例（如测试和生产），可以为每个实例创建独立的数据库容器和密码，实现完全隔离。

3.3 第三步：部署并配置Odoo 13应用容器

数据库就绪后，我们来部署Odoo应用。

  1. 在“映像”中找到odoo:13.0，点击“启动”。
  2. 容器名称：例如odoo13-app。
  3. 启用资源限制：同样建议设置，Odoo应用相对更耗资源，可以分配2-4核CPU和2048MB或更多内存，具体视NAS性能和预期用户数而定。
  4. 高级设置：
    • 卷：这里需要添加多个文件夹映射。
      • 添加文件夹/volume1/docker/odoo13/odoo/data，挂载路径为/var/lib/odoo。这是Odoo的数据目录。
      • （可选但推荐）添加文件夹/volume1/docker/odoo13/odoo/addons，挂载路径为/mnt/extra-addons。这样你可以将第三方或自研模块放入这个NAS文件夹，Odoo容器启动时会自动加载。
      • （可选）添加文件夹/volume1/docker/odoo13/odoo/config，挂载路径为/etc/odoo。你可以将自定义的odoo.conf配置文件放在这里。
    • 端口设置：这是让外部访问的关键。默认容器内Odoo运行在8069端口。我们需要将主机的某个端口映射到容器的8069端口。例如，在“本地端口”填18069（避免与群晖其他服务冲突），容器端口填8069。这样你就能通过http://你的群晖IP:18069访问Odoo了。
    • 链接：这是让Odoo容器能找到数据库容器的关键。点击“添加”，容器选择我们刚才创建的odoo13-db，别名（alias）可以设为db。这样在Odoo容器内部，可以通过主机名db来访问数据库容器。
    • 环境：通过环境变量来配置Odoo连接数据库。
      • HOST=db(这里填写的就是上一步链接的别名db)
      • USER=odoo(填写在数据库容器中设置的POSTGRES_USER)
      • PASSWORD=你设置的数据库密码(填写在数据库容器中设置的POSTGRES_PASSWORD)
      • （可选）PORT=5432(PostgreSQL默认端口)
  5. 点击“应用”，然后“下一步”，完成。稍等片刻，Odoo容器就会启动。

3.4 第四步：初始化访问与基本配置

打开浏览器，输入http://你的群晖IP:18069。你应该能看到Odoo的数据库创建页面。

  1. 创建数据库：在页面中，填写你想要的数据名称（例如mycompany），邮箱和密码（这是Odoo的超级管理员密码，与数据库密码不同，用于登录Odoo后台），选择语言（简体中文）。点击“创建数据库”。
  2. 等待初始化：系统会自动创建数据库并安装基础模块，这个过程可能需要几分钟，请耐心等待。
  3. 登录并探索：初始化完成后，会跳转到登录界面。用你刚才设置的邮箱和密码登录，就进入了Odoo 13的仪表盘。至此，一个完全免费、功能强大的企业ERP系统就已经在你的群晖上运行起来了。

首次登录后，建议先到“设置”菜单中，配置公司信息、时区、货币等基本信息。然后可以根据你的业务需求，从应用菜单中激活相应的模块，如销售、采购、库存、会计等。

4. 进阶配置与优化要点

基础部署完成后，为了让它更稳定、更安全、更好用，我们还需要进行一些优化。

4.1 使用自定义配置文件（odoo.conf）

通过环境变量配置虽然简单，但功能有限。使用配置文件可以提供更精细的控制。你可以在之前创建的/volume1/docker/odoo13/odoo/config目录下，创建一个名为odoo.conf的文件。内容示例如下：

[options] ; 数据库连接信息 db_host = db db_port = 5432 db_user = ooo db_password = 你的强密码 db_name = False ; 留空或False，允许在网页创建 ; 应用相关路径 addons_path = /mnt/extra-addons, /usr/lib/python3/dist-packages/odoo/addons data_dir = /var/lib/odoo ; 性能与安全优化 limit_memory_hard = 2684354560 ; 内存硬限制2.5GB limit_memory_soft = 2147483648 ; 内存软限制2GB limit_time_cpu = 600 ; 单个工作进程CPU时间限制 limit_time_real = 1200 ; 单个请求真实时间限制 list_db = False ; 禁止列出所有数据库，增强安全 proxy_mode = True ; 如果你通过反向代理访问（如群晖自带的反向代理），需要开启 ; 日志配置 logfile = /var/lib/odoo/odoo.log log_level = info

创建好配置文件后，需要修改Odoo容器的启动命令。在Container Manager中，停止并编辑odoo13-app容器。在“高级设置” -> “命令”中，填入--config=/etc/odoo/odoo.conf。同时，可以移除之前通过环境变量设置的HOST,USER,PASSWORD等，因为现在从配置文件读取。重启容器后，配置生效。

4.2 配置反向代理与HTTPS访问

直接通过IP和端口访问既不安全也不方便。我们可以利用群晖NAS自带的“反向代理服务器”功能（在套件中心安装），实现用域名（如erp.yourcompany.com）和HTTPS安全访问。

  1. 在控制面板 > 登录门户 > 高级 > 反向代理服务器中，新增一个规则。
  2. 来源：协议HTTPS，主机名填你的域名（如erp.yourcompany.com），端口443。
  3. 目的地：协议HTTP，主机名填localhost，端口填你映射的Odoo本地端口（如18069）。
  4. 保存。同时，你需要在域名服务商那里为这个域名配置DNS解析，指向你群晖的公网IP（或DDNS域名）。并在群晖的控制面板 > 安全性 > 证书中，为该域名申请或配置SSL证书。

这样，外部用户就可以通过https://erp.yourcompany.com安全地访问你的Odoo系统了，体验上与专业的SaaS服务无异。

4.3 性能调优与资源监控

随着数据量和用户数的增长，可能需要调优。

  • 调整容器资源：在Container Manager中监控odoo13-app容器的CPU和内存使用情况。如果经常接近上限，可以适当调高分配额度。
  • Odoo工作者进程：对于多用户并发访问，可以增加Odoo的工作者进程数量。在odoo.conf配置文件中添加workers = 4（根据CPU核心数调整，通常建议为核心数的1~2倍）。同时需要设置对应的limit_memory_hard和limit_memory_soft来限制每个进程的内存。
  • 启用缓存：Odoo支持多种缓存机制。对于生产环境，可以考虑配置Redis作为缓存服务器，这需要额外部署一个Redis容器并修改Odoo配置，能显著提升页面加载速度。
  • 数据库维护：定期对PostgreSQL数据库进行VACUUM和ANALYZE操作，可以回收空间并更新统计信息，优化查询性能。可以通过计划任务（crontab）在数据库容器内执行，或使用pgAdmin等工具远程管理。

5. 常见问题排查与维护技巧

即使按照步骤操作，也可能会遇到一些问题。这里记录一些我踩过的坑和解决方法。

5.1 容器启动失败或无法访问

  • 问题：Odoo容器状态显示“已退出”或不断重启。
  • 排查：首先查看容器日志。在Container Manager中，选中odoo13-app容器，点击“详情”->“日志”。最常见的错误是数据库连接失败。
  • 解决：
    1. 检查数据库容器odoo13-db是否正常运行。
    2. 检查Odoo容器中的环境变量或配置文件里的数据库连接信息（主机名、端口、用户名、密码）是否完全正确。特别注意：在容器链接模式下，主机名应填写链接时设置的别名（如db），而不是localhost或NAS的IP。
    3. 检查数据库密码是否含有特殊字符，有时需要转义。建议先用纯字母数字组合的密码测试。
    4. 检查端口映射是否正确，主机端口（如18069）是否被其他服务占用。

5.2 创建数据库时卡住或报错

  • 问题：在浏览器初始化页面点击“创建数据库”后，长时间无响应或报“Internal Server Error”。
  • 排查：查看Odoo应用容器的日志，通常会有更详细的错误信息。
  • 解决：
    1. 内存不足：这是最常见的原因。Odoo初始化安装模块需要较多内存。请确保为odoo13-app容器分配了足够的内存（至少2GB）。可以在容器设置中临时调高内存限制，初始化完成后再调回。
    2. 网络超时：容器间网络通信不稳定。确保两个容器在同一个Docker网络（默认的bridge即可）中，并且通过“链接”或自定义网络正确连接。
    3. 权限问题：检查映射到NAS的文件夹（如/volume1/docker/odoo13/...）是否有正确的读写权限。在File Station中，确保这些文件夹对Everyone至少有“读取”和“写入”权限。

5.3 如何备份与恢复？

这是生产环境必须掌握的技能。

  • 完整备份（推荐）：最简单可靠的方式是备份整个Docker数据目录。
    1. 停止odoo13-app和odoo13-db容器。
    2. 通过File Station或rsync等工具，将/volume1/docker/odoo13整个文件夹打包压缩，备份到另一个位置或云端。
    3. 恢复时，将备份解压到原路径，然后在Container Manager中重新启动两个容器即可。
  • 数据库逻辑备份：
    1. 进入odoo13-db容器的终端（通过Container Manager的“详情”->“终端机”->“新增”->“通过命令启动”）。
    2. 执行命令：pg_dump -U odoo 你的数据库名 > /var/lib/postgresql/data/backup.sql。这会在数据卷中生成一个备份文件，你可以在NAS的映射目录里找到它。
    3. 恢复时，先创建一个空数据库，然后使用psql -U odoo 新数据库名 < /var/lib/postgresql/data/backup.sql进行恢复。

5.4 升级与迁移

  • 小版本升级（如Odoo 13.0.x）：直接拉取新的odoo:13.0镜像（它会自动更新到最新小版本），停止旧容器，用新镜像以相同的配置（卷、端口、环境变量）创建一个新容器替换即可。数据库通常是向前兼容的。
  • 大版本升级（如Odoo 13 -> 16）：非常谨慎！这不是简单的容器替换。需要先在一个隔离的环境（如新建一套测试容器）中，将数据库备份恢复到新版本的Odoo中进行升级测试，验证所有自定义模块和业务流程是否兼容。确认无误后，再对生产环境进行割接。务必做好完整备份。
  • 迁移到另一台群晖：得益于Docker的便携性，迁移变得简单。在新NAS上安装好Container Manager，将整个/volume1/docker/odoo13目录（或你的备份）拷贝过去。然后按照相同的步骤，使用相同的镜像名称和标签创建数据库和Odoo容器，并确保卷的挂载路径与旧环境一致。启动后，应用和数据应该完好无损。

部署和运维这样一个系统，最大的体会就是“规划优于蛮干”。前期花点时间规划好目录结构、网络配置和备份策略，后期维护会轻松十倍。对于小微团队，这个方案在功能、成本和自主可控性之间找到了一个绝佳的平衡点。它让你完全掌控自己的业务数据，避免了SaaS服务的订阅费用和数据出海的顾虑，同时又能享受到接近专业级ERP系统的管理能力。

编程学习 学习日记 实战经验
← 返回列表