镜像与包：统一保存 Docker 镜像和通用软件包

1. 什么时候用包管理

源码放仓库，发布文件放 Release，跨项目复用或自动化上传的大文件更适合放软件包。这样权限、备份和下载记录都在同一个平台内。

• Docker 镜像：用于部署或测试环境。
• Generic Package：用于任意压缩包、工具包和固件集合。
• 依赖包：用于团队内部复用的库和工具。

2. 创建访问 Token

自动化上传不要使用账号密码。登录后进入个人设置，创建访问 Token，并只勾选当前任务需要的权限。Token 只显示一次，创建后请保存到安全位置。

• 上传包通常需要 package 相关权限。
• 脚本里的 Token 建议放到环境变量或 CI 密钥中。
• 成员离开项目后，管理员应及时回收 Token 或账号权限。

3. 推送 Docker 镜像

镜像地址以平台域名开头，命名时建议包含组织名、镜像名和版本。内网大文件上传优先走内网地址，异地用户走 HTTPS 地址。

docker login git.liuzi233.cn
docker tag 本地镜像:版本 git.liuzi233.cn/组织名/镜像名:版本
docker push git.liuzi233.cn/组织名/镜像名:版本

4. 上传通用软件包

Generic Package 适合保存任意文件。建议把项目名、版本号和文件名写清楚，避免多年后无法判断文件用途。

curl --user 用户名:访问Token \
  --upload-file ./工具包.zip \
  https://git.liuzi233.cn/api/packages/用户名/generic/包名/版本号/工具包.zip

详细包类型和 API 路径以后会统一放到教程站。如果上传失败，先检查 Token 权限、包名版本号和文件大小限制。