在 GitHub 添加两个 Secrets

GitHub 仓库。

进入:

Settings → Secrets and variables → Actions

然后:

New repository secret

创建第一个:

Name:
DOCKER_USERNAME

Value:

你的 Docker Hub 用户名

保存。

然后再创建第二个:

Name:
DOCKER_PASSWORD

Value:

刚才生成的 Docker Hub Access Token

保存。

最后应该看到:

Repository secrets

DOCKER_USERNAME
DOCKER_PASSWORD

然后提交刚才的 Actions 文件

点击:

Commit changes

提交以后,GitHub Actions 就会自动运行。

直接在 GitHub 网页创建文件夹

你不需要上传整个 .github 文件夹,直接在新项目中创建就行。

  1. 打开你的新 GitHub 仓库 。
  2. 点击 Add file → Create new file。
  3. 在文件名输入框中,完整填写:
.github/workflows/docker-publish.yml
  1. 把之前配置好的 Docker 自动构建 YAML 内容粘贴进去。
  2. 点击 Commit changes 保存。

GitHub 会自动创建 .github 和 workflows 两层目录。

注意:文件名必须是 docker-publish.yml,目录必须是 .github/workflows/,不能漏掉开头的点号。

name: Build and Push Docker Image

on:
  push:
    branches:
      - main
    tags:
      - 'v*'
  workflow_dispatch:

jobs:
  docker:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Docker Metadata
        id: meta
        uses: docker/metadata-action@v5
        with:
          images: 用户名/项目名称
          tags: |
            type=raw,value=latest,enable={{is_default_branch}}
            type=semver,pattern={{version}}

      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and Push
        uses: docker/build-push-action@v6
        with:
          context: .
          push: true
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}