Hullkeep v1.01.0817 — 首个公开版本 / First public release

中文

Hullkeep 的第一个公开版本。

Hullkeep 是一个自托管的 docker compose 容器升级面板，核心主张是数据安全：升级前自动备份（绑定目录和具名卷都打进同一份存档），升级后健康检查，失败一键回滚；存档可以在界面里直接翻看、一键恢复。零遥测——它不收集、不上报任何数据。

主要能力

• 升级四步走：升级前备份 → 改写 compose → 拉取新镜像 → 健康检查，失败可一键回滚到升级前的镜像与数据。
• 具名卷一起备份：绑定目录之外，docker 具名卷（named volume）也进备份、恢复时一起放回。
• 备份镜像目录：第二个目录里始终保有整套存档副本（异地/第二块盘）。
• 版本跨度提醒：升级确认弹窗告诉你这一跳跨了几个版本，并列出途经版本的更新说明。
• 七渠道通知：Bark、Telegram、飞书、企业微信、钉钉、Server酱、PushPlus。
• Telegram 机器人远程操作：查状态、升级、回滚、备份都能在聊天窗口完成，危险操作强制二次确认。
• 私有镜像仓库：保存登录凭据后，私有镜像照样检查更新、照样拉取。
• 中英双语界面，多架构镜像（amd64 / arm64）。

安装

在 NAS 上装？直接看平台教程：群晖 · 绿联 · 极空间；其它系统看通用安装教程。

git clone https://github.com/ailenshow/Hullkeep.git
cd Hullkeep
bash install.sh        # 一键安装：中文/英文引导，自动写 .env 并启动

或手动：

cp .env.example .env   # 编辑：把 HULLKEEP_DOCKER_ROOT 指向你的 compose 项目根目录
docker compose up -d   # 打开 http://<主机IP>:8180

镜像同时发布在两个仓库，哪个连得通用哪个（.env 里用 HULLKEEP_IMAGE 切换）：

镜像源	地址
GHCR（默认）	ghcr.io/ailenshow/hullkeep:latest
Docker Hub	docker.io/ailenshow/hullkeep:latest

首次登录：用户名默认 admin；密码在 .env 里设置，留空则自动生成并在容器日志里打印一次（docker compose logs hullkeep | grep password）。

---

English

The first public release of Hullkeep.

Hullkeep is a self-hosted upgrade panel for docker compose containers, built around one promise: your data always has a way back. Every upgrade backs up first (bind mounts and named volumes go into the same archive), health-checks after, and rolls back in one click if things go wrong. Archives are browsable and restorable right from the UI. Zero telemetry — it collects and reports nothing.

Highlights

• Four-step upgrades: backup → rewrite compose → pull → health check, with 1-click rollback to the pre-upgrade image and data.
• Named volumes included: backups cover docker named volumes alongside bind mounts, and restores put both back.
• Backup mirror directory: keep a full second copy of every archive on another disk or share.
• Version-span warning: the upgrade dialog tells you how many versions the jump crosses and lists the release notes along the way.
• Seven notification channels: Bark, Telegram, Lark/Feishu, WeCom, DingTalk, ServerChan, PushPlus.
• Telegram bot remote control: check status, upgrade, roll back and back up from chat; destructive actions require a one-time confirmation code.
• Private registries: store credentials once — private images get update checks and pulls like any other.
• Bilingual UI (English / Chinese), multi-arch images (amd64 / arm64).

Install

Installing on a NAS? See the platform guides: Synology · UGREEN · ZSpace (Chinese); for everything else, the generic guide.

git clone https://github.com/ailenshow/Hullkeep.git
cd Hullkeep
bash install.sh        # guided installer (English/Chinese), writes .env and starts the panel

Or manually:

cp .env.example .env   # edit: point HULLKEEP_DOCKER_ROOT at your compose projects root
docker compose up -d   # open http://<host-ip>:8180

The same image is published to two registries — use whichever your network reaches (switch with HULLKEEP_IMAGE in .env):

Registry	Image
GHCR (default)	ghcr.io/ailenshow/hullkeep:latest
Docker Hub	docker.io/ailenshow/hullkeep:latest

First login: username admin by default; set a password in .env, or leave it empty to get a generated one printed once in the container logs (docker compose logs hullkeep | grep password).