
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
https://img.shields.io/docker/pulls/mornedhels/icarus-server.svg](https://hub.docker.com/r/mornedhels/icarus-server) https://img.shields.io/docker/stars/mornedhels/icarus-server.svg](https://hub.docker.com/r/mornedhels/icarus-server) https://img.shields.io/docker/image-size/mornedhels/icarus-server/latest](https://hub.docker.com/r/mornedhels/icarus-server) https://img.shields.io/github/license/mornedhels/icarus-server](https://github.com/mornedhels/icarus-server/blob/main/LICENSE)
https://img.shields.io/badge/Repository-mornedhels/icarus--server-blue?logo=github](https://github.com/mornedhels/icarus-server)
ICARUS游戏的Docker镜像。该镜像基于https://hub.docker.com/r/cm2network/steamcmd/%E9%95%9C%E5%83%8F%EF%BC%8C%E5%B9%B6%E4%BD%BF%E7%94%A8supervisor%E5%A4%84%E7%90%86%E5%90%AF%E5%8A%A8%E3%80%81%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E5%92%8C%E6%B8%85%E7%90%86%E6%93%8D%E4%BD%9C%E3%80%82
| 变量 | 默认值 | 约束条件 | 描述 | 开发中 |
|---|---|---|---|---|
SERVER_NAME | ICARUS Server | 字符串 | 服务器名称 | |
SERVER_PASSWORD | 字符串 | 服务器密码 | ||
SERVER_ADMIN_PASSWORD | 字符串 | 管理员登录密码 | ||
SERVER_MAX_PLAYERS | 8 | 整数 | 最大允许玩家数 | |
SERVER_PORT | 17777 | 整数 | 服务器游戏端口 | |
SERVER_QUERYPORT | 27015 | 整数 | 服务器Steam查询端口 | |
SERVER_IP | 字符串 (ipv4) | 用于服务器空检查的服务器IP(更新定时任务) | ||
SERVER_SHUTDOWN_IF_NOT_JOINED | 300.000000 | 浮点数 | 已启动的勘探任务返回大厅模式前的秒数 | |
SERVER_SHUTDOWN_IF_EMPTY | 60.000000 | 浮点数 | 最后一名勘探者离开后服务器返回大厅模式前的秒数 | |
SERVER_ALLOW_NON_ADMINS_LAUNCH | True | 布尔值 | 允许所有勘探者在大厅模式中选择勘探任务 | |
SERVER_ALLOW_NON_ADMINS_DELETE | False | 布尔值 | 允许所有勘探者在大厅模式中删除勘探任务 | |
SERVER_RESUME_PROSPECT | True | 布尔值 | 服务器重启后恢复最后一个勘探任务 | |
GAME_BRANCH | public | 字符串 | ICARUS服务器的Steam分支 | |
ASYNC_TASK_TIMEOUT | 60 | 整数 | 在Engine.ini中设置AsyncTaskTimeout | |
PUID | 4711 | 整数 | 运行服务器的UID | |
PGID | 4711 | 整数 | 运行服务器的GID | |
UPDATE_CRON | 字符串 (cron格式) | 游戏服务器文件更新定时任务(例如 */30 * * * * 每30分钟检查更新) | ||
UPDATE_SKIP | false | 布尔值 | 容器启动时跳过更新(但仍会通过命令运行或在未找到服务器文件时运行) | |
CLEANUP_CRON | 字符串 (cron格式) | 旧勘探任务清理定时任务(检查是否所有玩家都已离开勘探任务) | ||
CLEANUP_DAYS | 1 | 整数 | 清理超过x天的旧勘探任务(检查是否所有玩家都已离开勘探任务) | |
CLEANUP_DELETE_BACKUPS | false | 布尔值 | 从已清理的勘探任务中删除备份文件 | |
CLEANUP_PRUNE_FOLDER | pruned | 字符串 | 已清理勘探任务的文件夹(相对于Prospects文件夹) | |
CLEANUP_EXCLUDES | 字符串 | 清理定时任务的排除模式(正则表达式),例如 world1|world2 | ||
STEAM_API_KEY (已弃用) | 字符串 | 用于授权请求的SteamApi密钥(服务器空检查所需) | ||
STEAMCMD_ARGS | --beta "$GAME_BRANCH" validate | 字符串 | 更新器的额外steamcmd参数 |
⚠️: 开发中
| 变量 | 描述 | 开发中 |
|---|---|---|
BOOTSTRAP_HOOK | 常规引导后运行的命令 | |
UPDATE_PRE_HOOK | 更新前运行的命令 | |
UPDATE_POST_HOOK | 更新后运行的命令 |
脚本将等待钩子解析/返回后再继续。
⚠️: 开发中
| 端口 | 描述 |
|---|---|
| ***/udp | 游戏端口 |
| 27015/udp | Steam查询端口 |
| 卷路径 | 描述 |
|---|---|
| /home/icarus/drive_c/icarus | 服务器配置文件和存档 |
| /opt/icarus | 游戏文件(Steam下载路径) |
注意: 默认情况下,卷使用UID和GID 4711创建(该用户不应存在)。要更改此设置,请设置环境变量PUID和PGID。
*不支持Windows(参见https://github.com/mornedhels/icarus-server/issues/46%EF%BC%89
yamlversion: "3" services: icarus: image: mornedhels/icarus-server:latest container_name: icarus hostname: icarus restart: unless-stopped stop_grace_period: 90s ports: - "17777:17777/udp" - "27015:27015/udp" volumes: - ./data:/home/icarus/drive_c/icarus - ./game:/opt/icarus environment: - SERVER_NAME=ICARUS Server - SERVER_PASSWORD=secret - SERVER_ADMIN_PASSWORD=evenmoresecret - SERVER_PORT=17777 - SERVER_QUERYPORT=27015 - PUID=4711 - PGID=4711
注意: 默认情况下,卷会创建在docker-compose.yml文件旁边。如果要在默认位置(如/var/lib/docker)创建卷,可以使用以下compose文件:
yamlversion: "3" services: icarus: image: mornedhels/icarus-server:latest container_name: icarus hostname: icarus restart: unless-stopped stop_grace_period: 90s ports: - "17777:17777/udp" - "27015:27015/udp" volumes: - data:/home/icarus/drive_c/icarus - game:/opt/icarus environment: - SERVER_NAME=ICARUS Server - SERVER_PASSWORD=secret - SERVER_ADMIN_PASSWORD=evenmoresecret - SERVER_PORT=17777 - SERVER_QUERYPORT=27015 - PUID=4711 - PGID=4711 volumes: data: game:
bashdocker compose exec icarus supervisorctl start icarus-force-update
bashdocker compose exec icarus ./icarus-commands loadProspect <ProspectName>
Freeing x bytes from backup pool to handle out of memory 和 Fatal error: [File: Unknown] [Line: 197] \nRan out of memory allocating 0 bytes with alignment 0\n,但系统有足够内存。
262144永久:bashsysctl -w vm.max_map_count=262144
bashecho "vm.max_map_count=262144" >> /etc/sysctl.conf && sysctl -p
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务