Apple M1设备Docker部署ERPNext遇平台匹配及访问问题求助

平台匹配问题解析 #

• linux/arm64与linux/arm64/v8本质兼容，但建议直接配置platform: linux/arm64/v8，和M1的实际平台完全对齐，消除模糊匹配可能引发的警告。
• 指定平台后仍出现警告，大概率是Compose文件中未给所有服务添加platform参数。比如ERPNext的部署包含web、worker、scheduler等多个服务，若仅给其中一个配置了平台参数，其他服务会默认拉取amd64镜像，触发警告。检查compose.yml内所有services节点，给每个服务都加上platform: linux/arm64/v8。

无法访问localhost的排查步骤 #

1. 验证端口映射：确认Compose文件中web服务的ports配置为8000:8000，执行docker ps查看容器端口绑定状态，确保存在0.0.0.0:8000->8000/tcp的映射。
2. 查看容器日志：执行docker logs <web容器ID>，排查启动阶段的报错（如依赖服务未就绪、端口被占用、权限异常）。常见问题是MariaDB/Redis服务未正常启动，导致ERPNext web服务无法建立连接。
3. 检查系统防火墙：暂时关闭macOS防火墙，测试是否能正常访问，排除防火墙拦截本地端口的可能。
4. 直接用容器IP访问：执行docker inspect <web容器ID>获取容器IP，尝试访问http://<容器IP>:8000，排除端口映射层面的问题。

M1 专属部署步骤（适配官方镜像） #

1. 准备适配版Compose文件：
   复制官方单服务器部署的Compose内容，给每个服务添加platform: linux/arm64/v8，示例片段：

   services:
     erpnext-web:
       image: frappe/erpnext:v14.48.0
       platform: linux/arm64/v8
       ports:
         - "8000:8000"
       depends_on:
         - erpnext-worker
         - mariadb
         - redis-cache
         - redis-queue
     # worker、scheduler、mariadb、redis等所有服务均需添加platform参数
   

2. 分步启动服务：
   先启动依赖服务，待其初始化完成后再启动ERPNext核心服务：

   docker-compose up -d mariadb redis-cache redis-queue
   # 等待1分钟，确保数据库完成初始化
   docker-compose up -d erpnext-web erpnext-worker erpnext-scheduler
   

3. 初始化站点：
   进入web容器，执行站点创建与配置命令：

   docker exec -it <web容器ID> bench new-site localhost --mariadb-root-password <你的数据库密码> --admin-password <你的管理员密码>
   docker exec -it <web容器ID> bench use localhost
   

4. 验证访问：
   等待2分钟让站点初始化完成，访问http://localhost:8000，使用设置的管理员账号密码登录。

额外注意事项 #

• 优先选择明确的版本号（如v14.xx）而非latest镜像，ARM64架构的版本支持更稳定。
• 若官方镜像仍存在兼容问题，可自行构建ARM64镜像：拉取frappe_docker仓库代码，执行docker buildx build --platform linux/arm64/v8 -t custom-erpnext .构建适配M1的专属镜像。

内容的提问来源于stack exchange，提问作者Vincent Fortin