本机安装（Windows / Mac · Docker Desktop）

本文说明在办公室电脑或笔记本上使用 Docker Desktop 部署 EspoCRM，并安装 Bring 外贸扩展。适合局域网试用、小团队内网办公；需要外网访问时可配合花生壳等内网穿透（见 BringCRM 部署方案）。

Mac 步骤与 Windows 类似，以下以 Windows 为主。

准备工作

• 本机已安装 Docker Desktop 并能正常启动（托盘图标无报错）
• Windows 需开启 WSL2 / 虚拟化（安装程序一般会引导）
• 建议配置：4 核 CPU、8 GB 内存 或以上；磁盘预留 10 GB+ 空闲空间
• Bring 外贸扩展 zip 从官网 下载与安装 获取

第一步：安装并启动 Docker Desktop

1. 下载并安装 Docker Desktop for Windows（Mac 用户选 Mac 版）
2. 首次启动按提示完成 WSL2 等依赖（Windows）
3. 确认 Docker 状态为 Running

第二步：生成 Docker Compose 配置

1. 打开本站 Docker Compose 配置生成工具

2. 填写：

   • 站点地址：本机试用可填 http://127.0.0.1:8080；局域网同事访问可填 http://本机局域网IP:8080（如 http://192.168.1.100:8080）
   • EspoCRM 管理员用户名与密码（请使用强密码并妥善保存）
   • 其它项可保持默认

3. 点击生成，复制完整的 docker-compose.yml 内容（或下载文件）

第三步：启动容器

1. 在本机新建文件夹（如 D:\bringcrm），将配置保存为 docker-compose.yml

2. 在该目录打开终端（PowerShell 或 CMD），执行：

   bash docker compose up -d

   也可在 Docker Desktop 的 Compose 中导入该文件并启动。

3. 等待镜像拉取与容器启动完成（首次可能需数分钟）

4. 浏览器访问第二步填写的站点地址，应能看到 EspoCRM 登录页

说明

编排除 CRM、数据库与 PDF 打印服务外，还包含 AI 助手与单证填模等配套容器；安装 Bring 扩展后会自动就绪，一般无需单独配置。

首次访问若出现 Espo 安装向导，按提示完成即可；工具已写入数据库信息时，多数情况下可直接登录。

第四步：安装 Bring 外贸扩展

1. 使用管理员账号登录 EspoCRM
2. 进入 管理 → 扩展
3. 上传从官网下载的 Bring 外贸扩展 zip，点击安装
4. 刷新页面，左侧导航应出现外贸相关菜单
5. 进入 管理 → Bring外贸 → Bring外贸许可，输入激活码完成授权

详细截图说明见 Linux 宝塔安装 第四步（扩展安装界面相同）。

第五步：安装 BringCRM 跟进助手（可选 · 标准版含）

标准版含 BringCRM 跟进助手 Chrome 扩展，便于在 WhatsApp Web 侧栏查客户、写跟进：

1. 从官网 下载与安装 下载 BringCRM 跟进助手 zip
2. 解压到固定目录
3. Chrome 打开 chrome://extensions → 开启 开发者模式 → 加载已解压的扩展程序 → 选择解压目录
4. 在扩展设置中填写 CRM 地址并登录（与 CRM 同域 Cookie）

用法详见 BringCRM 助手。

局域网与同事访问

• 同事在同一局域网内，用浏览器访问 http://您的局域网IP:8080 即可
• 本机防火墙需放行对应端口（默认 8080）

外网访问（可选）

只需在装系统的这台电脑安装贝锐花生壳等，把本地 8080 映射到对方提供的域名；外出同事用浏览器打开该域名即可，外出电脑无需再装软件。

常见问题

Docker 启动失败

• 确认虚拟化已在 BIOS 中开启
• Windows：确认 WSL2 已安装，wsl --update 后重启 Docker Desktop

端口被占用

• 修改 docker-compose.yml 中对外端口映射，或在生成工具里调整端口后重新生成

扩展安装后菜单未出现

• 管理后台执行 Rebuild，浏览器强制刷新
• 确认 zip 为 Bring 外贸扩展且 Espo 版本 ≥ 9.1

更多升级与维护见 升级。安装如需协助，请通过官网 联系我们。

---

← Linux 宝塔安装 · 返回产品概览