flnxi-Wu/docs/guides/REGISTRY_SETUP_COMPLETE.md
WuYongJie d1c6efc79d
Some checks failed
CI Check / check (push) Has been cancelled
feat: NAS 部署与 Harbor 推送流程
2025-12-03 14:39:06 +08:00

3.8 KiB
Raw Blame History

Docker Registry 搭建完成(已下线)

⚠️ 状态更新(2025-11):内网 Docker Registry(http://45.249.208.118:5000/5001)已正式停用,镜像统一迁移到 Harbor(https://harbor.flnxi.com)。本页面保留历史记录,并新增“清理旧 Registry 数据”步骤,避免遗留磁盘占用。

✅ 搭建状态(历史记录)

Registry 曾运行于:

🧹 清理旧 Registry 数据

如需清除服务器上的旧 Registry 组件与数据,可执行:

ssh root@45.249.208.118
cd /root/deploy

# 停止并移除旧 Registry
docker compose -f docker-compose.registry.yml down

# 删除残留数据
rm -rf /root/deploy/registry
rm -f /root/deploy/docker-compose.registry.yml

清理后,请统一使用 Harbor(https://harbor.flnxi.com/harbor/projects/5/repositories)管理镜像。

📋 下一步操作

以下内容为历史资料,如需重新部署内网 Registry,可按需参考。

1. (历史)在本地配置 Docker(Windows)

  1. 打开 Docker Desktop
  2. 进入 Settings → Docker Engine
  3. 添加以下配置:
{
  "insecure-registries": ["45.249.208.118:5000"]
}
  1. 点击 "Apply & Restart"

查看 Web UI(已停用)

2. (历史)测试 Registry

# 测试连接
curl http://45.249.208.118:5000/v2/

# 测试推送(在本地)
docker tag hello-world:latest 45.249.208.118:5000/hello-world:latest
docker push 45.249.208.118:5000/hello-world:latest

# 测试拉取(在服务器上)
docker pull 45.249.208.118:5000/hello-world:latest

3. (历史)使用 Registry 部署应用

# 使用 Registry 部署(项目根目录)
.\一键镜像部署.ps1 `
    -Server 45.249.208.118 `
    -Username root `
    -Password "your-password" `
    -RegistryHost "45.249.208.118:5000" `
    -RegistryNamespace "youyidian" `
    -RegistryImage "3d-material" `
    -Tag "latest"

🎯 实现的目标

✅ 一条命令部署 - 客户只需运行 docker compose up -d
✅ 无需源码 - 客户只需要配置文件
✅ 私有镜像 - 从 Registry 拉取,代码不泄露
✅ 完全自动化 - 自动配置所有服务

📦 创建客户部署包(推荐改用 Harbor)

运行以下命令生成客户部署包:

.\scripts\deploy\create-customer-package.ps1 -RegistryHost "45.249.208.118:5000"

这会生成 customer-deploy-package.zip,包含:

  • docker-compose.prod.yml - 生产配置
  • .env.example - 环境变量模板
  • README.md - 部署说明
  • install.sh - 快速安装脚本

🔧 Registry 管理(仅供参考)

查看 Registry 状态

# 在服务器上
docker compose -f /root/deploy/docker-compose.registry.yml ps
docker compose -f /root/deploy/docker-compose.registry.yml logs registry

查看存储的镜像

# Registry 数据存储在
/root/deploy/registry/data

清理旧镜像(可选)

# 进入 Registry 容器
docker exec -it docker-registry sh

# 执行垃圾回收
registry garbage-collect /etc/docker/registry/config.yml

📝 注意事项

  1. HTTP 模式:当前使用 HTTP(未启用 HTTPS),需要在 Docker 中配置 insecure-registries
  2. 无认证:当前未启用认证,如果需要可以后续添加
  3. 存储位置:镜像存储在 /root/deploy/registry/data,注意磁盘空间

🎉 完成

Registry 已搭建完成,现在可以:

  1. ✅ 推送镜像到 Registry
  2. ✅ 客户从 Registry 拉取镜像
  3. ✅ 实现一键部署目标