83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
# CT124 私有 Docker Registry — 操作手冊
|
||
|
||
> 主機:CT124（192.168.42.124，Ubuntu 24.04 LXC） | 位置:`/opt/registry`
|
||
> 元件:`registry:2`（:5000）+ `joxit/docker-registry-ui`（:8081）
|
||
|
||
---
|
||
|
||
## 一、架構
|
||
|
||
| 元件 | 容器 | Port | 對外網址（NPM 反代,HTTPS） |
|
||
|---|---|---|---|
|
||
| Registry | `registry` | `5000` | `https://registry.lotimmy.com` |
|
||
| Web UI | `registry-ui` | `8081` | `https://registry-ui.lotimmy.com` |
|
||
|
||
- UI 不直接打 registry,而是在 Docker 內網 `NGINX_PROXY_PASS_URL=http://registry:5000` 取資料。
|
||
- 開了 `REGISTRY_STORAGE_DELETE_ENABLED=true` + UI `DELETE_IMAGES=true` → **可從 UI 刪 image**。
|
||
- 資料存在 `./registry_data`(對應容器 `/var/lib/registry`)。
|
||
|
||
## 二、兩種存取路徑
|
||
|
||
**A. 對外 / 跨機(推薦):走 HTTPS,免設定**
|
||
```
|
||
registry.lotimmy.com/<image>
|
||
```
|
||
|
||
**B. 內網直連 :5000(HTTP):用戶端需先信任這個 insecure registry**
|
||
```jsonc
|
||
// /etc/docker/daemon.json（CT124 本機已設好;其他機器要推才需加）
|
||
{ "insecure-registries": ["192.168.42.124:5000"] }
|
||
```
|
||
改完 `systemctl restart docker`。
|
||
|
||
## 三、推送 image
|
||
|
||
```bash
|
||
# 1. tag 成 registry 的命名空間
|
||
docker tag my-app registry.lotimmy.com/my-app
|
||
# 或內網:docker tag my-app 192.168.42.124:5000/my-app
|
||
|
||
# 2. push
|
||
docker push registry.lotimmy.com/my-app
|
||
|
||
# 3. 別台機器拉
|
||
docker pull registry.lotimmy.com/my-app
|
||
```
|
||
|
||
## 四、查詢
|
||
|
||
```bash
|
||
# 所有 repo
|
||
curl https://registry.lotimmy.com/v2/_catalog
|
||
# 某 repo 的 tags
|
||
curl https://registry.lotimmy.com/v2/my-app/tags/list
|
||
```
|
||
或直接開 UI:`https://registry-ui.lotimmy.com`。
|
||
（目前內容:`files-to-prompt`、`speedtest-ookla`）
|
||
|
||
## 五、刪 image 與回收空間
|
||
|
||
刪 tag/manifest(UI 按刪除,或 API)只是標記,**不會真的釋放磁碟**。要回收:
|
||
|
||
```bash
|
||
# 在 CT124 上
|
||
docker exec registry registry garbage-collect /etc/docker/registry/config.yml
|
||
# 視版本可能要重啟讓 UI 同步
|
||
docker restart registry
|
||
```
|
||
|
||
## 六、維運
|
||
|
||
```bash
|
||
cd /opt/registry
|
||
docker compose up -d # 啟動 / 套用變更（start_docker_registry.sh 也是做這件事）
|
||
docker compose logs -f registry
|
||
docker compose restart
|
||
```
|
||
|
||
## 七、注意事項
|
||
|
||
- **沒有帳號密碼驗證**:registry 本身未設 htpasswd,對外安全完全靠 NPM 反代那層。內網 `:5000` 等於對 LAN 全開,push/pull/delete 都不擋。要鎖就在 registry 加 `REGISTRY_AUTH=htpasswd` 或在 NPM 上加 basic auth。
|
||
- 對外 443 經 NPM → 依賴 docker daemon 與 NPM 容器(見 [`CT124_故障復原_20260529.md`](CT124_故障復原_20260529.md) 的相依鏈);docker 掛了 `registry.lotimmy.com` 也會跟著不通,內網 `:5000` 仍可用。
|
||
- `myfile.txt` 是舊的手記草稿,正式說明以本文為準。
|