actions-mirrors

组织介绍

actions-mirrors 是一个常用 GitHub Actions 的 Gitee 镜像组织，主要为国内开发者和 CI/CD 环境提供更稳定、便捷的 Action 源码访问。

本组织专注于同步 Java、Web、Docker 和通用构建流程中常用的 GitHub Actions，包括：

• 源码检出与构建缓存；
• Java、Node.js、Python 等开发环境配置；
• Maven、Gradle、npm、pnpm 等构建工具支持；
• Docker Buildx、镜像构建与镜像仓库登录；
• 制品上传、下载、发布和远程部署；
• 测试、代码质量与供应链安全工具。

镜像说明

组织内仓库同步自对应的 GitHub 上游开源仓库，原则上保留：

• Git 提交历史；
• 分支和版本标签；
• Action 定义文件；
• 开源许可证；
• 上游项目文档。

镜像仓库不修改上游项目源码，也不代表 GitHub 或上游项目官方。

使用方式

如果 CI/CD 平台支持通过「组织名/仓库名@版本」引用 Gitee Action，可以按照平台要求引用对应镜像，例如：

steps:
  - name: Checkout
    uses: actions-mirrors/checkout@v4

  - name: Setup Java
    uses: actions-mirrors/setup-java@v4
    with:
      distribution: temurin
      java-version: "21"

不同 CI/CD 平台对 Action 来源的解析方式可能不同。使用前请确认当前 Runner 是否支持 Gitee 仓库，或是否需要配置 Action 镜像地址。

Gitea Actions 兼容性说明

Gitea Actions 以兼容 GitHub Actions 为目标，但并非完全等价。接入本组织镜像前，请结合 Runner 版本和 Gitea 实例配置，核对 Gitea「与 GitHub Actions 的对比」文档。该页面对应 Gitea 1.25 文档，具体行为可能随版本变化。

Action 来源与下载地址

• Gitea 支持在 uses 中使用 Action URL 绝对路径，例如 uses: https://gitee.com/actions-mirrors/checkout@v4。这适合明确指定镜像来源，或 Gitea 实例无法访问 GitHub 的网络环境。
• 使用 uses: actions/checkout@v4 等相对路径时，Gitea 默认可能从 GitHub 下载 Action。管理员也可以通过 [actions].DEFAULT_ACTIONS_URL 将相对路径解析到当前 Gitea 实例；请根据实例配置确认实际下载位置。

工作流语法限制

Gitea 1.25 文档列出的暂不支持或存在限制的 GitHub Actions 语法包括：

• concurrency、run-name；
• permissions 和 jobs.<job_id>.permissions；
• jobs.<job_id>.timeout-minutes、jobs.<job_id>.continue-on-error、jobs.<job_id>.environment；
• 复杂形式的 runs-on（目前主要支持 runs-on: xyz 或 runs-on: [xyz]）；
• hashFiles 表达式（结果可能始终为空字符串）。

此外，表达式支持范围、问题匹配器、错误注释，以及预处理、后处理和服务步骤在界面中的展示，也可能与 GitHub Actions 不同。依赖这些能力的工作流应先在目标 Gitea Runner 上验证。

迁移建议

1. 优先使用 Action URL 绝对路径，或确认实例的 DEFAULT_ACTIONS_URL 配置；
2. 检查工作流是否使用上述不兼容语法和表达式；
3. 在与生产环境一致的 Gitea Runner 上执行一次完整流程；
4. 对 Action、Runner 和 Gitea 版本进行记录，升级后重新验证。

版本与安全

镜像同步可能存在一定延迟。生产环境使用前，建议核对以下内容：

1. Gitee 镜像与 GitHub 上游的 Commit SHA；
2. 使用的版本标签是否存在；
3. 上游项目是否发布安全公告；
4. Action 所需的 Token 和权限范围；
5. 第三方 Action 是否应固定到完整 Commit SHA。

申请同步

如果组织中没有需要的 Action，可以提交 Issue，并提供：

• GitHub 源码地址；
• GitHub Marketplace 地址；
• Action 的主要用途；
• 建议同步的分支和版本标签；
• 使用场景及优先级。

免责声明

本组织仅提供第三方开源镜像服务，与 GitHub 及各上游项目维护者不存在官方隶属关系。

所有代码版权、开源许可证、使用文档、版本说明和安全公告均以上游 GitHub 仓库为准。

参考

• 如何使用 Actions
• Gitea：与 GitHub Actions 的对比