这个仓库是我为尝试用 GitHub Action 构建美化后的 OpenWebUI Docker 镜像而创建的
本项目使用 GitHub Actions 自动构建 Docker 镜像并推送到 Docker Hub。当你推送符合 v*.*.* 格式的标签时(例如 v1.0.0),会自动触发构建流程。
如果你 fork 了本项目并希望自动构建推送到自己的 Docker Hub 账号,需要在 GitHub 仓库中设置以下 Secrets:
DOCKERHUB_USERNAME: 你的 Docker Hub 用户名DOCKERHUB_TOKEN: 你的 Docker Hub 访问令牌(不要使用密码,请在 Docker Hub 创建访问令牌)DOCKERHUB_REPO: (可选)你希望推送到的仓库名称,默认为 "study"
- 登录 Docker Hub
- 点击右上角头像 → Account Settings → Security
- 点击 "New Access Token"
- 为令牌命名(例如 "GitHub Actions")并选择适当的权限(我选择的是 read/write 权限)
- 复制生成的令牌并保存到 GitHub Secrets
- 在你 fork 的仓库中,点击 "Settings"
- 在左侧菜单中选择 "Secrets and variables" → "Actions"
- 点击 "New repository secret"
- 添加上述三个 secrets
完成这些设置后,当你推送新的版本标签时,GitHub Actions 将自动构建镜像并推送到你指定的 Docker Hub 仓库。
- 进入你 fork 后的 GitHub 仓库
- 点击顶部导航栏中的 "Settings" 选项卡
- 在左侧菜单中找到 "Secrets and variables"
- 点击展开并选择 "Actions"
对于每个 Secret,点击 "New repository secret" 按钮,然后填写以下信息:
- 名称:DOCKERHUB_USERNAME
- 值:你的 Docker Hub 用户名
- 示例:如果你的 Docker Hub 账号是 "myusername",则填写 "myusername"
- 名称:DOCKERHUB_TOKEN
- 值:你在 Docker Hub 创建的访问令牌(不是密码)
- 注意:这是一个敏感信息,创建后将无法再次查看完整令牌,请妥善保存
- 名称:DOCKERHUB_REPO
- 值:你想推送镜像的仓库名称
- 示例:如果你想推送到 "myusername/myapp",则填写 "myapp"
- 默认值:如果不设置此项,将默认使用 "study" 作为仓库名
添加完所有 Secrets 后,页面将显示如下:
所有这些 Secrets 都会被安全地存储,并且只会在工作流运行时使用,不会暴露在日志或其他可见的输出中。
要触发自动构建,你需要创建并推送一个符合 v*.*.* 格式的Git标签。以下是完整的命令示例:
# 确保你的更改已提交
git add .
git commit -m "准备发布 v1.0.0"
# 创建标签
git tag v1.0.0
# 推送标签到GitHub(这将触发构建)
git push origin v1.0.0