{% extends "base.html" %} {% block title %}构建平台配置 · RustDesk 客户端定制平台{% endblock %} {% block content %}

构建平台配置

选择实际执行构建任务的平台：GitHub Actions（云托管构建机）或自建 Gitea Actions（构建机自备、可全内网运行）。 支持在本页直接配置（优先级最高），也继续兼容 docker-compose 环境变量方式。

{# ===== 配置状态总览 ===== #}
配置状态检查当前平台：{{ build_platform_label }}
{% if build_ready and not warnings %}
{{ build_platform_label }} 构建服务配置完整，可以正常提交客户端构建任务。
{% else %} {% endif %}
{# ===== 配置表单 ===== #}
{% csrf_token %} {# --- 构建平台选择（自定义平台卡，单选） --- #}
构建平台

切换后仅影响新提交的构建任务；历史任务仍保存在原平台并可继续查询状态与日志。

{# --- 各配置分组（platform 组已在上方自定义渲染） --- #} {% for group_key, group_title, group_desc in groups %}{% if group_key != 'platform' %}
{{ group_title }}

{{ group_desc }}

{% for row in rows %}{% if row.group == group_key %}
{{ row.field }} {% if row.sensitive %}
{% if row.source == 'db' %} 已在后台保存 {% elif row.source == 'env' %} 已通过环境变量配置 {% else %} 未配置（使用默认值） {% endif %}
{% endif %} {% if row.help %}
{{ row.help }}
{% endif %}
{% endif %}{% endfor %}
{% endif %}{% endfor %} {# --- 保存与连接测试（始终可见，测试目标跟随当前所选平台） --- #}
{# ===== GitHub 配置引导 ===== #}
GitHub 首次配置引导（约 5 分钟）
  1. Fork 构建仓库

    打开上游仓库 github.com/bryangerlach/rdgen ， 点击右上角 Fork 复制到你自己的 GitHub 账号下。

  2. 启用 GitHub Actions

    进入 Fork 后的仓库页面，打开 Actions 页面 ， 如页面提示则点击绿色的 Enable Actions 按钮。

  3. 创建 Fine-grained 访问令牌（PAT）

    打开 Generate new token ， 按如下设置后生成，并把令牌（github_pat_ 开头）填入上方「GitHub 访问令牌」：

    • Repository access：选择 Only select repositories，勾选你 Fork 的仓库
    • Repository permissions：Actions 设为 Read and write，Workflows 设为 Read and write
    • Expiration 建议按需设置，过期后需要回到这里更新令牌
  4. 添加两个仓库 Secret

    打开仓库 Settings → Secrets and variables → Actions ， 分别 New repository secret：

    • GENURL：本平台的公网访问地址，须与上方「本平台外部访问地址」一致，例如 https://rdgen.example.com
    • ZIP_PASSWORD：一个随机强密码（可用 python3 -c 'import secrets; print(secrets.token_hex(100))' 生成）， 须与上方「配置压缩包密码」完全一致
  5. 保存并验证

    填写上方表单后点击「保存配置」，再点击「测试 GitHub 连接」，看到「连接正常」提示即配置完成，可以去客户端定制页提交构建了。

{# ===== Gitea 配置引导 ===== #}
Gitea 首次配置引导（需自备 Gitea 与构建机）
  1. 部署 Gitea 1.27+ 并准备构建仓库

    自建一个 Gitea 实例（建议 1.27 或更高版本，低版本不支持运行详情回传）， 把本项目仓库推送到该实例（仓库内含 .gitea/workflows 适配工作流）。 官方 Quick Start

  2. 启用仓库 Actions

    进入 {% if gitea_server and gitea_owner %} 仓库设置页 {% else %}仓库设置页{% endif %} ，勾选 Enable Repository Actions。

  3. 注册 act_runner 构建机

    在仓库 Settings → Actions → Runners 创建注册令牌，并在构建机上安装注册 act_runner：

    • Linux：可用 Docker 模式（需预装 QEMU 以构建 arm64）；
    • Windows：只能 host 模式直接跑在 Windows 机器上（MSVC/Flutter/vcpkg 环境）；
    • macOS：只能 host 模式跑在 Apple 硬件上；
    • runner 自定义标签需与工作流一致：ubuntu-22.04、ubuntu-22.04-arm、windows-2022、macos-14、macos-15-intel。
  4. 配置仓库 Secrets

    在仓库 Settings → Actions → Secrets 中添加 GENURL（本平台地址）与 ZIP_PASSWORD（与上方完全一致）； 如需 Android/macOS 签名，再添加 ANDROID_SIGNING_KEY、MACOS_P12_BASE64、SIGN_BASE_URL、SIGN_API_KEY。

  5. 第三方 actions 的网络说明

    工作流使用的第三方 action 默认从 github.com 拉取；纯内网环境请为 runner 配置出网白名单， 或在 Gitea 的 app.ini 配置 [actions].DEFAULT_ACTIONS_URL 走自建 action 镜像。 完整部署步骤（含 vcpkg 文件缓存配置）见项目 setup.md 的「Gitea 部署附录」。

  6. 保存并验证

    填写上方 Gitea 配置后点击「保存配置」，再点击「测试 Gitea 连接」，看到「连接正常」提示即可提交构建。

{# ===== 环境变量方式说明 ===== #}
环境变量方式（可选，继续支持）

也可以在 docker-compose.yml 的 environment 中配置以下变量，容器重启后自动生效； 本页保存的同名配置优先级更高（值与环境变量相同时会自动回退，不产生重复覆盖）。

环境变量对应配置说明
BUILD_PLATFORM构建平台github（默认）或 gitea
GHUSERGitHub 用户名Fork 仓库所在账号
GHBEARERGitHub 访问令牌Fine-grained PAT，Actions/Workflows 读写
GENURL平台外部访问地址两平台共用，供构建机回传产物，公网/内网可访问
ZIP_PASSWORD配置压缩包密码两平台共用，须与仓库 Secret 一致
REPONAMEGitHub 仓库名称默认 rdgen
GHBRANCHGitHub 工作流分支默认 master
PROTOCOL平台访问协议https（默认）或 http
SH_SECRETGitHub 自托管 Runner 密钥仅 GitHub 自托管构建时使用
WEBHOOK_SECRET回调校验密钥两平台共用，留空不校验
GH_PROXYGitHub 访问代理如 http://host:port，留空直连
GITEA_SERVER_URLGitea 服务器地址如 https://gitea.example.com
GITEA_TOKENGitea 访问令牌需仓库 Actions 读写权限
GITEA_OWNERGitea 仓库属主用户名或组织名
GITEA_REPOGitea 仓库名称默认 rdgen
GITEA_BRANCHGitea 工作流分支默认 master
GITEA_PROXYGitea 访问代理内网直连通常留空
{% endblock %} {% block head_extra %} {% endblock %}