oyvindkinsey/unifi-hassio
oyvindkinsey
自动构建
这是一个适配Hassio环境的Ubiqiti UniFi控制器Docker镜像，支持非root运行、自定义配置与证书，便于管理UniFi网络设备（如AP、交换机）。
下载次数: 0状态：自动构建维护者：oyvindkinsey仓库类型：镜像最近更新：8 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
oyvindkinsey/unifi-hassio 镜像说明
镜像概述
本镜像为适配Hassio环境的Ubiqiti UniFi控制器容器化版本，基于jacobalberty/unifi镜像修改，用于集中管理Ubiqiti网络设备（包括无线AP、交换机、安全网关等），支持多种部署方式与自定义配置。
核心功能
- 非root运行：通过
RUNAS_UID0=false切换为非root用户（UID/GID 999）运行，提升容器安全性。 - 时区配置：通过
TZ环境变量设置容器时区（如Asia/Shanghai）。 - 数据持久化：绑定
/unifi/data（配置数据）、/unifi/log（日志）等卷，确保数据不丢失。 - 设备接入：支持Layer2（主机网络/macvlan）和Layer3（SSH命令）两种设备Adoption方式。
- 证书支持：挂载自定义SSL证书到
/unifi/cert目录，实现HTTPS加密访问。 - 外部MongoDB集成：通过
DB_URI等变量连接外部MongoDB服务器，扩展存储能力。
使用场景
- 家庭/小型企业UniFi网络设备的集中管理。
- Hassio智能家居环境中，与智能设备联动的网络管理需求。
- 容器化部署UniFi控制器的场景。
配置说明
环境变量
| 变量名 | 说明 |
|---|---|
RUNAS_UID0 | 是否以root运行，建议设为false |
TZ | 时区设置（如Asia/Shanghai） |
BIND_PRIV | 是否允许绑定1024以下端口，默认true |
CERTNAME | 自定义证书文件名（默认cert.pem） |
CERT_PRIVATE_NAME | 自定义私钥文件名（默认privkey.pem） |
卷挂载
/unifi/data：存储UniFi配置数据/unifi/log：存储日志文件/unifi/cert：挂载自定义SSL证书目录
暴露端口
- 8080/tcp：设备命令控制端口
- 8443/tcp：Web界面与API端口
- 3478/udp：STUN服务端口
- ***/udp：UBNT设备发现端口
部署示例
Docker Run命令
bash# 创建数据和日志目录 mkdir -p ~/unifi/data ~/unifi/log # 启动容器（适配Hassio） docker run --init -d \ --name unifi-hassio \ -p 8080:8080 \ -p 8443:8443 \ -p 3478:3478/udp \ -p 10001:10001/udp \ -e TZ="Asia/Shanghai" \ -e RUNAS_UID0=false \ -v ~/unifi/data:/unifi/data \ -v ~/unifi/log:/unifi/log \ docker.xuanyuan.run/oyvindkinsey/unifi-hassio:latest
Layer3设备接入示例
通过SSH连接到UniFi设备，执行以下命令：
shellmca-cli set-inform [***]<主机IP>:8080/inform
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 unifi-hassio 镜像标签
docker pull docker.xuanyuan.run/oyvindkinsey/unifi-hassio:<标签>
DockerHub 原生拉取命令
docker pull oyvindkinsey/unifi-hassio:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
