
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Codiad是一个基于Web的IDE框架,具有小占用空间和低系统需求的特点。LinuxServer.io团队提供的此镜像包含定期的应用更新、简单的用户映射(PGID、PUID)、自定义基础镜像与s6覆盖层、每周基础OS更新(跨整个LinuxServer.io生态系统的通用层以最小化空间使用、停机时间和带宽)以及定期安全更新。可通过WebUI的市场添加更多插件。
本镜像支持多种架构,如x86-64、arm64和armhf。我们利用Docker清单实现多平台识别。只需拉取linuxserver/codiad即可获取适合您架构的正确镜像,也可通过标签拉取特定架构的镜像。
| 架构 | 标签 |
|---|---|
| x86-64 | amd64-latest |
| arm64 | arm64v8-latest |
| armhf | arm32v6-latest |
以下是帮助您开始创建容器的示例代码片段。
docker create \ --name=codiad \ -e PUID=1001 \ -e PGID=1001 \ -e TZ=Europe/London \ -p 80:80 \ -v <path to data>:/config \ --restart unless-stopped \ linuxserver/codiad
兼容docker-compose v2架构。
--- version: "2" services: codiad: image: docker.xuanyuan.run/linuxserver/codiad container_name: codiad environment: - PUID=1001 - PGID=1001 - TZ=Europe/London volumes: - <path to data>:/config ports: - 80:80 mem_limit: 4096m restart: unless-stopped
容器镜像通过运行时传递的参数进行配置(如上所示)。这些参数以冒号分隔,表示<外部>:<内部>。例如,-p 8080:80会将容器内的80端口暴露到主机IP的8080端口。
| 参数 | 功能 |
|---|---|
-p 80 | WebUI端口 |
-e PUID=1001 | 用户ID - 详见下文说明 |
-e PGID=1001 | 组ID - 详见下文说明 |
-e TZ=Europe/London | 指定时区,例如Europe/London |
-v /config | Codiad存储数据的位置 |
使用卷(-v标志)时,主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的任何卷目录都由您指定的同一用户拥有,权限问题将迎刃而解。
在此示例中PUID=1001和PGID=1001,要查找您的ID,请使用id user命令:
$ id username uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)
docker exec -it codiad /bin/bashdocker logs -f codiaddocker inspect -f '{{ index .Config.Labels "build_version" }}' codiaddocker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/codiad我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器以更新内部应用。除部分例外(如nextcloud、plex),我们不建议或支持在容器内更新应用。
以下是更新容器的说明:
docker pull docker.xuanyuan.run/linuxserver/codiaddocker stop codiaddocker rm codiad/config文件夹和设置将被保留)docker start codiaddocker image prunedocker-compose pull linuxserver/codiaddocker-compose up -ddocker image prune您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务