Docker 部署 Home Assistant：在群晖 NAS 或 Linux 上打造家庭智能中枢

本文基于 homeassistant/home-assistant:2026.7.1 镜像Ubuntu 24.04 服务器实测IP192.168.1.18端口8123群晖 NAS同样推荐SSH docker run部署Web 访问与初始化步骤一致米家、涂鸦、各品牌 App 各管各的数据还往云端跑Home Assistant是开源家庭自动化平台——主打本地控制与隐私优先把灯、传感器、打印机、摄像头等设备统一接入自动化规则跑在你自己的服务器上断网也能继续工作。典型场景Ubuntu / 云服务器、群晖 / 威联通等 NAS7×24 常开作为家庭智能家居中枢。本文带你用Docker 单容器跑通 Home Assistant Container轩辕镜像加速拉取、SSHdocker run一键启动Ubuntu 与群晖均推荐命令行、持久化/config挂载再跟做Web 初始化向导——Ubuntu 24.04 全程实测附18 张截图与完整命令文末 FAQ 收录UFW / 群晖 DSM 防火墙 8123 未放行踩坑修复并演示自动发现并集成局域网HP Smart Tank打印机。国内用户从 Docker Hub 拉取可能较慢本文使用 轩辕镜像 加速。官方安装说明见 Home Assistant InstallationContainer 专项文档见 Install on Linux — Container。一、Home Assistant 是什么Home Assistant是一款开源家庭自动化工具由全球社区维护适合部署在树莓派、NAS 或本地服务器上。核心理念数据留在本地、用户掌握设备管理权同时支持上千种设备集成与灵活自动化。能力说明设备集成支持灯、开关、传感器、打印机、摄像头等数千种设备自动化基于触发器 / 条件 / 动作创建场景与规则仪表盘浏览器自定义控制面板手机 App 可远程访问需额外配置本地优先断网后本地自动化仍可运行隐私数据不上传云端典型使用场景Ubuntu / 云服务器、群晖 / 威联通等 NAS作为家庭智能家居中枢替代各品牌云端 App私有化统一管理设备与自动化。Container 与 HA OS 的区别Home Assistant 有两种主流安装方式。本文采用Home Assistant ContainerDocker 单容器适合已有 Linux Docker 或群晖 Container Manager的用户功能HA OS推荐新手Container本文自动化 / 仪表盘 / 集成✅✅Add-on 商店✅❌一键系统更新✅需手动 pull 镜像Thread / Z-Wave Add-on✅❌需自行配置部署复杂度需专用镜像/硬件已有 Docker 即可部署要点Container 模式必须使用--networkhost不能用-p 8123:8123简单端口映射替代配置持久化在宿主机/config目录。无 Add-on 商店Thread、Z-Wave 等需 HA OS 的集成在 Container 下需额外方案。架构示意浏览器 ──HTTP:8123──▶ Home Assistant 容器host 网络 宿主机 config 目录 ──▶ /config配置、数据库、自动化 · Ubuntu/www/wwwroot/homeassistant/config · 群晖 /volume1/docker/homeassistant/config 容器 ──mDNS/局域网──▶ 智能设备打印机、灯、传感器等 USB Zigbee 棒可选──▶ --device /dev/ttyUSB0二、环境要求2.1 Ubuntu 服务器本文实测项目建议操作系统Linux本文Ubuntu 24.04DockerDocker Engine ≥ 23.0须 EngineDocker Desktop 不适用内存≥ 2 GB推荐 4 GBCPU双核 2.0 GHz 以上磁盘≥ 10 GB镜像约3.42 GB/config持久化端口8123Web 界面host 网络直接占用工作目录/www/wwwroot/homeassistant独立目录勿与其他项目混用验证 Dockerdocker--versiondockercompose version若尚未安装 Docker可使用轩辕镜像一键脚本bash(wget-qO- https://xuanyuan.cloud/docker.sh)2.2 群晖 NAS推荐 SSH 部署项目建议设备群晖 NASDS920plus 等 x86 / arm64 均可需确认架构与镜像标签匹配系统DSM 7.x已安装Container Manager原 Docker 套件内存≥ 2 GB建议 4 GBHA 常驻内存占用高于轻量容器CPU双核 2.0 GHz 以上磁盘≥ 10 GB镜像约3.42 GB/config持久化端口8123host 网络模式下 DSM 直接占用SSH建议开启本文推荐 SSH 命令行部署与 MT Photos 等同理工作目录/volume1/docker/homeassistant验证 DockerSSH 终端docker--version群晖 NAS 镜像加速配置见 群晖 NAS Docker 镜像源配置教程。为何群晖也推荐 SSHHome Assistant Container必须--networkhost与--privilegedContainer Manager 图形界面配置 host 网络、特权模式较繁琐且易漏项SSH 一条docker run与 Ubuntu 完全相同复制即用。部署完成后浏览器访问http://群晖IP:8123Web 初始化向导与下文第八十节完全一致无需重复操作。更多安装说明见 轩辕镜像使用手册。镜像标签怎么选Home Assistant 在 Docker Hub 提供多种标签完整列表见 轩辕镜像标签页。常用标签与拉取命令如下dockerpull docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1# 本文实测固定版本号dockerpull docker.xuanyuan.run/homeassistant/home-assistant:stable# 当前稳定版通道dockerpull docker.xuanyuan.run/homeassistant/home-assistant:latest# 最新稳定构建dockerpull docker.xuanyuan.run/homeassistant/home-assistant:beta# 测试版含未正式发布功能dockerpull docker.xuanyuan.run/homeassistant/home-assistant:rc# 候选发布版稳定版发布前验证用标签更新频率适用场景生产环境建议2026.7.1版本号固定不变文档复现、生产锁定、升级可控推荐。本文采用升级时手动改版本号stable随稳定版发布推进希望pull时始终拿到当前稳定版可用每次 pull 可能跨小版本升级前建议备份/configlatest通常指向最新稳定构建快速体验、个人测试可用但不建议生产标签指向可能随仓库策略变化beta每轮开发周期更新尝鲜新功能、参与测试不推荐生产可能含未稳定特性rc稳定版发布前夕验证即将发布的版本不推荐生产仅预发布验证选型建议家庭 / 生产 NAS 长期运行优先2026.7.1等具体版本号或stable 定期备份后手动升级个人尝鲜latest或beta升级前无论哪种标签先备份/config再docker pull→ 重建容器官方 GHCR 镜像ghcr.io/home-assistant/home-assistant:stable与 Docker Hub 标签体系类似本文统一使用轩辕加速的Docker Hub 路径homeassistant/home-assistant。镜像大小参考Ubuntu 24.04 实测2026.7.1项目数值磁盘占用DISK USAGE3.42 GB镜像内容大小CONTENT SIZE622 MB压缩层建议预留磁盘≥10 GB镜像 /config数据库与日志增长三、拉取镜像SSH 登录Ubuntu 服务器或群晖 NAS拉取 Home Assistant 镜像命令相同。标签选择见第二节「镜像标签怎么选」更多版本见 homeassistant/home-assistant 标签列表。dockerpull docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1成功时终端类似输出2026.7.1: Pulling from homeassistant/home-assistant 5835c1c32669: Pull complete ... Digest: sha256:f73512ba4fe06bb4d57636fe3578d0820cdec46f81e8f837ab59e451662ff3cb Status: Downloaded newer image for docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1 docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1拉取完成后可用docker images确认本地镜像2026.7.1磁盘占用约3.42 GBdockerimages实测输出摘要IMAGE ID DISK USAGE CONTENT SIZE EXTRA docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1 f73512ba4fe0 3.42GB 622MB U官方镜像轩辕镜像加速拉取说明homeassistant/home-assistant:2026.7.1docker pull docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1本文主镜像固定版本homeassistant/home-assistant:stabledocker pull docker.xuanyuan.run/homeassistant/home-assistant:stable当前稳定版通道homeassistant/home-assistant:latestdocker pull docker.xuanyuan.run/homeassistant/home-assistant:latest最新稳定构建homeassistant/home-assistant:betadocker pull docker.xuanyuan.run/homeassistant/home-assistant:beta测试版homeassistant/home-assistant:rcdocker pull docker.xuanyuan.run/homeassistant/home-assistant:rc候选发布版镜像页homeassistant/home-assistant · 标签列表tags四、创建数据目录Home Assistant 所有配置、数据库、自动化规则写入容器内/config必须挂载到宿主机持久化。删除容器后只要保留该目录重建容器即可恢复全部配置。4.1 Ubuntumkdir-p/www/wwwroot/homeassistant/configcd/www/wwwroot/homeassistant宿主机目录容器内路径用途/www/wwwroot/homeassistant/config/config必挂配置、SQLite 数据库、自动化、集成数据4.2 群晖 NASSSH 登录群晖后执行mkdir-p/volume1/docker/homeassistant/configcd/volume1/docker/homeassistant宿主机目录容器内路径用途/volume1/docker/homeassistant/config/config必挂配置、数据库、自动化、集成数据也可在File Station中手动创建docker/homeassistant/config文件夹效果相同。五、启动容器docker runHome Assistant Container必须使用 host 网络与 privileged 模式。Ubuntu 与群晖命令结构相同仅/config挂载路径不同。注意不要使用-p 8123:8123替代 host 网络——会导致 mDNS 发现失败及部分集成异常。5.1 Ubuntu 服务器dockerrun-d\--namehomeassistant\--privileged\--restartunless-stopped\-eTZAsia/Shanghai\-v/www/wwwroot/homeassistant/config:/config\-v/run/dbus:/run/dbus:ro\--networkhost\docker.xuanyuan.run/homeassistant/home-assistant:2026.7.15.2 群晖 NASSSH推荐dockerrun-d\--namehomeassistant\--privileged\--restartunless-stopped\-eTZAsia/Shanghai\-v/volume1/docker/homeassistant/config:/config\-v/run/dbus:/run/dbus:ro\--networkhost\docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1参数说明--networkhost必须。HA 监听宿主机 8123mDNS 设备发现依赖 host 网络--privileged设备发现、部分硬件集成需要群晖上同样必填-e TZAsia/Shanghai时区国内建议上海-v ...:/config持久化配置与数据库路径见第四节-v /run/dbus:/run/dbus:ro蓝牙集成可选无蓝牙可省略--restartunless-stopped系统 / 群晖重启后自动恢复若有 Zigbee / Z-Wave USB 棒追加设备映射先用lsusb确认--device/dev/ttyUSB0:/dev/ttyUSB0群晖 USB 设备路径可能为/dev/ttyUSB0或/dev/ttyACM0以ls -l /dev/serial/by-id/为准。六、验证启动与防火墙6.1 确认容器运行dockerps-a|grephomeassistant正常时状态为Up9fae6b9a3846 docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1 /init ... Up ... homeassistant6.2 查看日志dockerlogs-fhomeassistant首次启动 s6 初始化后日志可能出现 Python SyntaxWarning可忽略。首次完整启动通常需220 分钟。6.3 确认 8123 端口监听ss-tlnp|grep8123有输出表示 HA 核心已启动LISTEN 0 128 0.0.0.0:8123 0.0.0.0:* users:((python3,pid3555006,fd9)) LISTEN 0 128 [::]:8123 [::]:* users:((python3,pid3555006,fd11))6.4 本机 curl 测试curl-Ihttp://127.0.0.1:8123返回HTTP/1.1 405 Method Not Allowed表示服务已响应curl -I发送 HEAD 请求HA 仅允许 GET属正常。用 GET 验证curl-s-o/dev/null-w%{http_code}\nhttp://127.0.0.1:8123返回200或302即 Web 正常。6.5 UbuntuUFW 防火墙放行 8123实测踩坑若本机 curl 正常、Windows 浏览器访问http://192.168.1.18:8123出现ERR_CONNECTION_TIMED_OUT检查 UFWufw status本文实测 UFW 为active放行列表中无 8123导致局域网无法访问。执行ufw allow8123/tcp若使用宝塔面板安全 → 额外放行8123端口。确认服务器 IPipaddr|grep192.168.1本文输出inet 192.168.1.18/24 ... enp0s256.6 群晖DSM 防火墙放行 8123群晖无 UFW若浏览器访问http://群晖IP:8123超时检查控制面板 → 安全性 → 防火墙确认防火墙已启用时新增规则允许TCP 8123端口入站或在同一局域网内测试时临时关闭防火墙验证是否为拦截原因SSH 本机测试与 Ubuntu 相同curl-s-o/dev/null-w%{http_code}\nhttp://127.0.0.1:8123返回200或302表示 HA 已就绪此时若外网/其他设备仍无法访问优先排查 DSM 防火墙规则。七、Docker Compose 方案可选验证docker run正常后可改用 Compose 便于后续维护。7.1 Ubuntu在/www/wwwroot/homeassistant/docker-compose.ymlservices:homeassistant:container_name:homeassistantimage:docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1volumes:-/www/wwwroot/homeassistant/config:/config-/etc/localtime:/etc/localtime:ro-/run/dbus:/run/dbus:rorestart:unless-stoppedprivileged:truenetwork_mode:hostenvironment:TZ:Asia/Shanghai迁移步骤dockerstop homeassistantdockerrmhomeassistantcd/www/wwwroot/homeassistantdockercompose up-d7.2 群晖 Container Manager 图形界面可选若偏好 DSM 可视化管理可用Container Manager → 项目创建 Compose 项目路径建议/volume1/docker/homeassistant-project。docker-compose.ymlservices:homeassistant:container_name:homeassistantimage:docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1volumes:-/volume1/docker/homeassistant/config:/config-/etc/localtime:/etc/localtime:ro-/run/dbus:/run/dbus:rorestart:unless-stoppedprivileged:truenetwork_mode:hostenvironment:TZ:Asia/Shanghai注意若已用 SSHdocker run创建同名容器需先docker stop homeassistant docker rm homeassistant避免容器名冲突。Compose 中network_mode: host与privileged: true不可省略图形界面创建项目时务必核对这两项。仍建议首次部署用第五节 SSHdocker run验证通过后再迁移 Compose排错更直观。群晖上 Compose 启动后在Container Manager → 容器中可看到homeassistant状态为运行中Web 访问方式与 Ubuntu完全相同http://群晖IP:8123。八、Web 初始化向导浏览器访问Ubuntu 与群晖格式相同将 IP 换为你的设备地址http://192.168.1.18:8123 # Ubuntu 实测 http://你的群晖IP:8123 # 群晖 NAS说明无论部署在 Ubuntu 还是群晖Web 界面、初始化向导、设备集成步骤完全一致。下文截图基于 Ubuntu 实测群晖用户跟做即可。8.1 欢迎页首次进入显示欢迎界面点击「创建我的智能家居」开始全新配置亦可上传备份还原图 1欢迎页左下角语言已切换为简体中文8.2 创建用户填写姓名、用户名、密码点击「创建账户」图 2创建首个管理员账户本文用户 Sean Chang安全提示请选择强密码并妥善保存该账户拥有 Home Assistant 全部管理权限。8.3 设置家的位置搜索并选择家庭所在城市本文选择杭州市地图会定位到对应坐标——影响日出日落、天气等集成图 3设置家庭地理位置8.4 分析与隐私Home Assistant 询问是否分享匿名使用数据可按需开关各项点击「下一步」图 4分析与隐私设置可全部关闭8.5 自动发现设备向导扫描局域网本文自动发现Internet Printing Protocol (IPP)打印机集成点击「完成」图 5局域网设备自动发现九、主界面功能概览初始化完成后进入 Home Assistant 主界面。左侧为导航栏右侧为各功能模块。9.1 概览仪表盘默认概览页显示欢迎语、区域卡片客厅 / 厨房 / 卧室 / 设备与右侧摘要已发现设备、天气图 6概览页右侧显示 1 个设备可添加、杭州天气9.2 地图地图页在 OpenStreetMap 上显示家庭位置标记杭州市图 7地图模块9.3 能源能源模块引导配置电网、太阳能等能源监控6 步向导可按需跳过图 8能源模块初始化第 1 步共 6 步9.4 活动日志活动页记录系统事件。本文可见Home Assistant started及 Sun 实体日出日落变更图 9活动日志启动时间 13:51:49 与容器日志一致9.5 媒体媒体页提供 AI 生成图片、摄像头、Radio Browser、文字转语音等媒体源图 10媒体浏览器9.6 待办事项清单内置购物清单待办列表可新建其他清单图 11待办事项 / 购物清单9.7 设置设置页集中管理集成、自动化、区域、人员、系统备份与重启图 12设置主页十、添加首个设备HP Smart Tank 打印机Home Assistant 在局域网自动发现了HP Smart Tank 210-220 series网络打印机与 CUPS 部署教程 中同一台设备。以下演示从发现到集成的完整流程。10.1 发现设备弹窗概览页弹出「您想要添加什么」已发现列表中显示 HP Smart Tank图 13概览页设备发现弹窗10.2 确认添加打印机点击 HP Smart Tank 条目确认「您想设置 HP Smart Tank 210-220 series [DAD28A] 吗」点击「提交」图 14确认添加打印机10.3 命名与分配区域为设备命名默认HP Smart Tank 210-220 series分配到客厅区域点击「完成」图 15命名设备并分配区域10.4 客厅仪表盘集成成功后客厅区域卡片显示打印机状态四色墨盒余量100%打印机状态空闲图 16打印机集成后的客厅仪表盘10.5 设备详情进入设备页查看制造商 HP、固件版本、序列号及 IPP 集成信息传感器显示墨盒余量与状态图 17HP Smart Tank 设备详情与传感器10.6 创建自动化可选设备页可将打印机作为触发器 / 条件 / 动作快速创建自动化或脚本图 18基于打印机创建自动化或脚本十一、可选扩展11.1 USB Zigbee / Z-Wave 棒Container 模式无 Add-on但可通过--device映射 USB 控制器# docker run 追加--device/dev/ttyUSB0:/dev/ttyUSB0Compose 等效devices:-/dev/ttyUSB0:/dev/ttyUSB011.2 蓝牙集成需挂载 D-Bus本文 docker run 已包含-v/run/dbus:/run/dbus:ro11.3 ARM 设备 jemalloc 报错部分 ARM64 硬件页大小 4K可能出现Unsupported system page size追加环境变量-eDISABLE_JEMALLOCtrue十二、生产环境建议12.1 固定镜像 digestdockerpull docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1dockerinspect docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1--format{{index .RepoDigests 0}}本文拉取 digestsha256:f73512ba4fe06bb4d57636fe3578d0820cdec46f81e8f837ab59e451662ff3cb12.2 备份 /configUbuntutar-czfhomeassistant-config-backup-$(date%Y%m%d).tar.gz-C/www/wwwroot/homeassistant config群晖tar-czf/volume1/docker/homeassistant-config-backup-$(date%Y%m%d).tar.gz-C/volume1/docker/homeassistant config也可在设置 → 系统 → 备份中创建完整备份Ubuntu / 群晖 Web 界面相同。12.3 更新镜像dockerpull docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1cd/www/wwwroot/homeassistantdockercompose down# 或 docker stop homeassistant docker rm homeassistantdockercompose up-d# 或重新 docker run12.4 Nginx 反向代理示例若需通过域名 HTTPS 访问生产建议配合 Authentik 或 HA 信任代理配置server { listen 443 ssl; server_name ha.example.com; location / { proxy_pass http://127.0.0.1:8123; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # WebSocket 支持 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; } }需在 Home Assistantconfiguration.yaml中配置http:信任代理详见 官方反向代理文档。十三、常见问题 FAQQ1浏览器访问 8123 超时但curl 127.0.0.1:8123正常UbuntuUFW 或宝塔未放行8123。执行ufw allow 8123/tcp宝塔安全面板同步放行。本文实测即为此场景。群晖检查控制面板 → 安全性 → 防火墙新增允许TCP 8123入站规则。Q2群晖能用 Container Manager 图形界面部署吗可以但更推荐 SSH docker run见第五节 5.2。HA 必须network_mode: hostprivileged: true图形界面容易漏配命令与 Ubuntu 仅路径不同。部署完成后访问http://群晖IP:8123Web 初始化与 Ubuntu完全相同。Q3能否用-p 8123:8123代替 host 网络不建议。官方要求 Container 使用 host 网络否则 mDNS 发现、部分集成如 Cast、Sonos可能异常。Q4首次启动多久能访问通常220 分钟。用ss -tlnp | grep 8123确认端口监听后再访问浏览器。Q5curl -I返回 405 是报错吗不是。HA 对 HEAD 请求返回 405表示服务已运行。浏览器 GET 请求正常。Q6Container 与 HA OS 怎么选已有 Linux Docker、熟悉命令行 → Container本文。想要 Add-on 商店、一键更新、Thread/Z-Wave 官方 Add-on → 选 HA OS 或 Green/Yellow 硬件。Q7日志里 SyntaxWarning 需要处理吗本文出现的py.warnings ... SyntaxWarning: return in a finally block来自依赖库可忽略不影响运行。Q8如何重启 Home Assistantdockerrestart homeassistant# 或 Composedockercompose restart也可在设置 → 系统中点击重启。Q98123 端口被占用怎么办ss-tlnp|grep8123确认无其他进程占用。Home Assistant 仅支持改configuration.yaml中http:端口但 host 网络下改端口后访问地址也需同步变更。Q10如何远程访问生产环境建议 Nginx 反向代理 HTTPS 强认证或使用 Home Assistant CloudNabu Casa安全隧道。勿将 8123 裸暴露到公网。Q11配置存在哪里Ubuntu/www/wwwroot/homeassistant/config群晖/volume1/docker/homeassistant/config删除容器不丢数据重建时挂载同目录即可恢复。Q12群晖上需要像 MT Photos 那样设置 PUID/PGID 吗不需要。Home Assistant 容器以 root 在/config内写数据群晖上直接挂载/volume1/docker/homeassistant/config即可无 MT Photos 的 PostgreSQL 权限踩坑。Q13stable、latest、beta、rc和2026.7.1怎么选生产 / 长期运行用2026.7.1等具体版本号本文推荐升级时改版本号并备份/config想始终跟稳定版用stable或latest每次docker pull可能跨版本升级前务必备份尝鲜测试beta/rc不要用于生产完整标签与拉取命令见 轩辕镜像标签列表 及本文第二节。十四、命令速查操作Ubuntu群晖 NAS拉取镜像docker pull docker.xuanyuan.run/homeassistant/home-assistant:2026.7.1同左创建目录mkdir -p /www/wwwroot/homeassistant/configmkdir -p /volume1/docker/homeassistant/config启动容器见5.1/www/wwwroot/...挂载见5.2/volume1/docker/...挂载查看日志docker logs -f homeassistant同左本机测试curl -s -o /dev/null -w %{http_code}\n http://127.0.0.1:8123同左防火墙ufw allow 8123/tcp控制面板 → 安全性 → 防火墙 → 允许 8123Web 访问http://服务器IP:8123http://群晖IP:8123界面相同停止服务docker stop homeassistant docker rm homeassistant同左总结本文完成了 Home Assistant2026.7.1 单容器 Container 私有化部署Ubuntu 24.04 实测 群晖 NAS SSH 部署说明使用轩辕镜像加速拉取 homeassistant/home-assistant:2026.7.1Ubuntu / 群晖均推荐 SSH docker runhost 网络 privileged/config持久化Ubuntu 工作目录/www/wwwroot/homeassistant群晖/volume1/docker/homeassistantUFW / 群晖 DSM 防火墙 8123 未放行导致局域网超时放行后恢复正常Web 初始化向导 5 步跟做Ubuntu 与群晖访问:8123后步骤完全相同自动发现并集成局域网HP Smart Tank 210-220打印机18 张配图延伸阅读Home Assistant 轩辕镜像页Home Assistant 镜像标签列表Home Assistant 官方安装指南Linux Container 安装文档CUPS Docker 部署教程同一台 HP 打印机群晖 NAS Docker 镜像源配置轩辕镜像使用手册轩辕镜像 AI 规范 agents.md