
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像为适用于Apple MacOS Arm64架构(如搭载M系列芯片的Mac设备)的Nacos Server,解决了官方Nacos Server镜像在该环境下运行时出现的com.alibaba.nacos.api.exception.runtime.NacosRuntimeException: ErrCode:500, ErrMsg:Function not implemented错误。镜像基于官方Nacos Server Dockerfile构建,仅将基础镜像替换为centos:8.3.2011以适配MacOS Arm64环境,确保与官方版本功能一致。
centos:8.3.2011基础镜像构建,提供稳定的运行环境由于本镜像未发布至公共仓库,需自行构建,步骤如下:
FROM指令改为:
dockerfileFROM centos:8.3.2011
(将bashdocker build -t nacos-server-macos-arm64:${VERSION} .
${VERSION}替换为Nacos Server版本号,如2.3.2)基本运行命令
bashdocker run -d \ --name nacos-server \ -p 8848:8848 \ -e MODE=standalone \ nacos-server-macos-arm64:${VERSION}
参数说明
| 参数 | 说明 |
|---|---|
-d | 后台运行容器 |
--name | 指定容器名称 |
-p 8848:8848 | 映射容器端口8848到主机,Nacos默认服务端口 |
-e MODE=standalone | 指定Nacos运行模式为单机模式(开发测试常用) |
环境变量配置
支持官方Nacos Server的所有环境变量配置,常用配置如下:
| 环境变量 | 描述 | 默认值 |
|---|---|---|
MODE | 运行模式,可选standalone(单机)或cluster(集群) | cluster |
NACOS_SERVER_PORT | Nacos服务端口 | 8848 |
SPRING_DATASOURCE_PLATFORM | 数据库平台,可选mysql等(单机模式默认使用嵌入式数据库) | empty |
MYSQL_SERVICE_HOST | MySQL数据库主机(当SPRING_DATASOURCE_PLATFORM=mysql时需配置) | - |
MYSQL_SERVICE_PORT | MySQL数据库端口 | 3306 |
MYSQL_SERVICE_DB_NAME | MySQL数据库名称 | nacos_config |
MYSQL_SERVICE_USER | MySQL数据库用户名 | nacos |
MYSQL_SERVICE_PASSWORD | MySQL数据库密码 | nacos |
容器启动后,通过浏览器访问 http://localhost:8848/nacos 即可打开Nacos控制台,默认用户名/密码为 nacos/nacos。
创建docker-compose.yml文件:
yamlversion: '3' services: nacos-server: image: nacos-server-macos-arm64:${VERSION} container_name: nacos-server ports: - "8848:8848" environment: - MODE=standalone - NACOS_SERVER_PORT=8848 restart: always
启动命令:
bashdocker-compose up -d
以下是 suvue/nacos-server 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务