ERPLibre/ERPLibre
GitHub: ERPLibre/ERPLibre
ERPLibre 是 Odoo 社区版的软分叉版本，提供自动化部署、多版本支持和开发运维一体化工具链，帮助企业快速搭建可自主掌控的 ERP/CRM 平台。
Stars: 20 | Forks: 27
# ERPLibre
ERPLibre 是一个 CRM/ERP 平台，包含 Odoo 社区版开源模块的自动化安装、维护和开发功能。它是 Odoo 社区版 (OCE) 的一个“软分叉”，旨在向上游回馈贡献。
它基于一套生产就绪的模块，由 Odoo 社区协会 (OCA) 和专业公司生态系统提供支持。该解决方案确保本地环境中的数字主权，同时集成预训练的生成式 Transformer (GPT)，为数据管理和自动化带来了新的维度。
在 Mastodon 上关注我们：https://fosstodon.org/@erplibre
# 功能
- **多版本 Odoo 支持**：在同一个工作空间中运行 Odoo 12.0、13.0、14.0、15.0、16.0、17.0 和 18.0，拥有独立的 Python 虚拟环境（`.venv.erplibre` 和 `.venv.odooXX`）
- **交互式 CLI (TODO.py)**：用于安装、执行、数据库管理、代码格式化、移动端编译等的引导式交互工具。使用 `make` 启动
- **代码生成器**：自动生成 Odoo 模块，支持视图、门户、代码片段、继承、i18n 和 JavaScript
- **Selenium 自动化**：使用 Selenium Grid 进行 Web 测试和自动化，支持视频录制和登录自动化
- **移动应用程序**：ERPLibre Home Mobile (Owl + Capacitor)，通过 TODO.py 编译和部署
- **Docker 部署**：带有 PostgreSQL 18 和 PostGIS 的生产就绪 Docker 镜像
- **部署工具**：Nginx、Apache、Cloudflare DDNS、Certbot SSL、systemd 服务
- **数据库工具**：备份、恢复、克隆、版本间迁移、生产环境到开发环境迁移
- **性能工具**：每秒请求数测量、并行测试执行、覆盖率分析
# 支持的 Odoo 版本
| Odoo 版本 | Python | 状态 |
|--------------|---------|------------|
| 18.0 | 3.12.10 | Active |
| 17.0 | 3.10.18 | Inactive |
| 16.0 | 3.10.18 | Inactive |
| 15.0 | 3.8.20 | Deprecated |
| 14.0 | 3.8.20 | Deprecated |
| 13.0 | 3.7.17 | Deprecated |
| 12.0 | 3.7.17 | Deprecated |
使用 `make switch_odoo_18`、`make switch_odoo_16` 等命令在版本之间切换。
# 支持的平台
- **Linux** : Ubuntu 20.04, 22.04, 24.04, 25.04; Debian 12; Arch Linux
- **macOS** : 通过 pyenv
- **Windows** : 通过 WSL 或 Docker
- **Mainframe** : 390x 架构
# 生产环境安装
## 在 Ubuntu 或 Debian 上使用 Docker 轻松安装
这已在 Debian 12 和 Ubuntu 24.04 LTS 中经过测试。
**注意**：这适用于测试环境、本地网络或未直接暴露于互联网的类似环境。
1. 确保已安装 Docker 和 nginx Web 服务器：
`sudo apt install docker.io docker-compose-v2 nginx` 2. 获取最新的 ERPLibre Docker compose 文件：
`wget https://raw.githubusercontent.com/ERPLibre/ERPLibre/master/docker-compose.yml` 3. 安装 ERPLibre 并以守护进程（Web 服务器）模式运行 Docker：
`sudo docker compose up -d` 4. 在此网页打开最终安装步骤：
`http://[server IP]:8069/web/database/manager`
 5. 通过提供数据库名称、电子邮件和密码完成安装，然后点击 **Create Database**。 根据您的系统资源，**这可能需要超过 2 分钟且没有反馈！** 请检查浏览器的加载指示器。 6. 接下来，网页将自动重新加载，您应该会看到 ERPLibre 中的应用程序列表：
 您现在可以个性化您的 ERPLibre 安装。 欲了解更多信息，请阅读 [Docker 指南](./docker/README.md)。 ## 从源代码安装 ### 自动安装 针对 Debian/Ubuntu ``` sudo apt install make python3 ``` 克隆项目： ``` git clone https://github.com/ERPLibre/ERPLibre.git cd ERPLibre ``` 按照以下脚本中的说明操作，它将尝试检测您的环境。 ``` make ``` ### 手动安装 在 Ubuntu 中，最小依赖项： ``` sudo apt install make git curl ``` 在 Ubuntu 中，开发者依赖项： ``` sudo apt install make build-essential libssl-dev zlib1g-dev libreadline-dev libsqlite3-dev curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev liblzma-dev libbz2-dev libldap2-dev libsasl2-dev ``` 克隆项目： ``` git clone https://github.com/ERPLibre/ERPLibre.git cd ERPLibre ``` 支持 Ubuntu 20.04、22.04、24.04、25.04 和 OSX。 ``` make install_os make install_odoo_18 ``` 安装特定 Odoo 版本： ``` make install_odoo_16 make install_odoo_17 make install_odoo_18 ``` 如果您需要从 127.0.0.1 以外的接口运行，请更新您的配置，文件 `config.conf` ``` xmlrpc_interface = 0.0.0.0 ``` 显示版本： ``` make version ``` 准备执行： ``` make run ``` # 测试 使用其代码生成器执行 ERPLibre 测试。 ``` time make test_full_fast ``` # 文档 | 指南 | 描述 | |-------|-------------| | [DISCOVER](doc/DISCOVER.md) | 学习和探索 ERPLibre | | [DEVELOPMENT](doc/DEVELOPMENT.md) | 开发环境设置 | | [PRODUCTION](doc/PRODUCTION.md) | 生产服务器部署 | | [RUN](doc/RUN.md) | 执行模式和用例 | | [CODE_GENERATOR](doc/CODE_GENERATOR.md) | Odoo 模块代码生成 | | [MIGRATION](doc/MIGRATION.md) | 版本间数据库迁移 | | [GIT_REPO](doc/GIT_REPO.md) | Git 仓库管理 | | [POETRY](doc/POETRY.md) | Python 依赖管理 | | [FAQ](doc/FAQ.md) | 常见问题解答 | | [HOWTO](doc/HOWTO.md) | 操作指南 | | [WINDOWS_INSTALLATION](doc/WINDOWS_INSTALLATION.md) | Windows 安装 | # 贡献 请参阅 [CONTRIBUTION.md](doc/CONTRIBUTION.md) 了解指南。 # 许可证 本项目基于 [GNU Affero General Public License v3.0](LICENSE) 授权。
`sudo apt install docker.io docker-compose-v2 nginx` 2. 获取最新的 ERPLibre Docker compose 文件：
`wget https://raw.githubusercontent.com/ERPLibre/ERPLibre/master/docker-compose.yml` 3. 安装 ERPLibre 并以守护进程（Web 服务器）模式运行 Docker：
`sudo docker compose up -d` 4. 在此网页打开最终安装步骤：
`http://[server IP]:8069/web/database/manager`
 5. 通过提供数据库名称、电子邮件和密码完成安装，然后点击 **Create Database**。 根据您的系统资源，**这可能需要超过 2 分钟且没有反馈！** 请检查浏览器的加载指示器。 6. 接下来，网页将自动重新加载，您应该会看到 ERPLibre 中的应用程序列表：
 您现在可以个性化您的 ERPLibre 安装。 欲了解更多信息，请阅读 [Docker 指南](./docker/README.md)。 ## 从源代码安装 ### 自动安装 针对 Debian/Ubuntu ``` sudo apt install make python3 ``` 克隆项目： ``` git clone https://github.com/ERPLibre/ERPLibre.git cd ERPLibre ``` 按照以下脚本中的说明操作，它将尝试检测您的环境。 ``` make ``` ### 手动安装 在 Ubuntu 中，最小依赖项： ``` sudo apt install make git curl ``` 在 Ubuntu 中，开发者依赖项： ``` sudo apt install make build-essential libssl-dev zlib1g-dev libreadline-dev libsqlite3-dev curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev liblzma-dev libbz2-dev libldap2-dev libsasl2-dev ``` 克隆项目： ``` git clone https://github.com/ERPLibre/ERPLibre.git cd ERPLibre ``` 支持 Ubuntu 20.04、22.04、24.04、25.04 和 OSX。 ``` make install_os make install_odoo_18 ``` 安装特定 Odoo 版本： ``` make install_odoo_16 make install_odoo_17 make install_odoo_18 ``` 如果您需要从 127.0.0.1 以外的接口运行，请更新您的配置，文件 `config.conf` ``` xmlrpc_interface = 0.0.0.0 ``` 显示版本： ``` make version ``` 准备执行： ``` make run ``` # 测试 使用其代码生成器执行 ERPLibre 测试。 ``` time make test_full_fast ``` # 文档 | 指南 | 描述 | |-------|-------------| | [DISCOVER](doc/DISCOVER.md) | 学习和探索 ERPLibre | | [DEVELOPMENT](doc/DEVELOPMENT.md) | 开发环境设置 | | [PRODUCTION](doc/PRODUCTION.md) | 生产服务器部署 | | [RUN](doc/RUN.md) | 执行模式和用例 | | [CODE_GENERATOR](doc/CODE_GENERATOR.md) | Odoo 模块代码生成 | | [MIGRATION](doc/MIGRATION.md) | 版本间数据库迁移 | | [GIT_REPO](doc/GIT_REPO.md) | Git 仓库管理 | | [POETRY](doc/POETRY.md) | Python 依赖管理 | | [FAQ](doc/FAQ.md) | 常见问题解答 | | [HOWTO](doc/HOWTO.md) | 操作指南 | | [WINDOWS_INSTALLATION](doc/WINDOWS_INSTALLATION.md) | Windows 安装 | # 贡献 请参阅 [CONTRIBUTION.md](doc/CONTRIBUTION.md) 了解指南。 # 许可证 本项目基于 [GNU Affero General Public License v3.0](LICENSE) 授权。
标签：AGPLv3, Capacitor, Cloudflare, CRM平台, DevOps工具, Docker, ERP系统, GPT集成, IP 地址批量处理, Linux服务器, MITRE ATT&CK, Nginx, OCA, Odoo, Owl框架, PostGIS, PostgreSQL, Python, Selenium自动化, Systemd, Web自动化, 代码生成器, 企业资源计划, 低代码, 单元测试, 安全防御评估, 客户关系管理, 开源ERP, 性能测试, 数字主权, 数据可视化, 数据库管理, 无后门, 测试用例, 特权提升, 生成式AI, 移动应用, 系统迁移, 索引, 自动化部署, 请求拦截, 软分叉, 逆向工具