Drone 一定要配合 Gitea 吗？

不一定。Drone 支持 Gitea、GitHub、GitLab、Bitbucket 等多种代码源。本文以 Gitea 为例，是因为它和 Drone 都是轻量自托管组合，零额外月费；若你代码在 GitHub，把 DRONE_GITEA_* 换成对应的 GitHub 配置即可。

流水线一直排队不跑怎么办？

最常见是 server 与 runner 的 DRONE_RPC_SECRET 不一致，或 runner 没挂 /var/run/docker.sock。确认两边密钥相同、runner 容器正常起来，再看 Drone 后台 Runner 是否在线。

密钥、Token 能写进 .drone.yml 吗？

不能。敏感信息应在 Drone 仓库设置的 Secret 里添加，.drone.yml 中用 from_secret 引用，避免明文进代码仓库造成泄露。

雨云优惠码 admin01 怎么用？

下单页优惠码/推广码输入框填 admin01 即享五折，以结算页显示为准。Drone 是常驻轻量服务，建议先开最低配月付验证，雨云支持 7 天无理由退款。

雨云搭建 Drone 持续集成

代码推上去还要手动登服务器拉、编译、重启，次数一多就烦，也容易漏步骤。CI（持续集成）就是让「推送代码」自动触发构建测试。Drone 是一个轻量开源 CI/CD，配置就是一个 .drone.yml，和雨云搭建 Gitea 这套自建 Git 服务是绝配——Gitea 管代码，Drone 管流水线。本文用一台雨云 KVM 云服务器，把 Drone server + runner 拉起来，接上 Gitea 做「提交即构建」。

一、先准备一台雨云 KVM 云服务器

Drone server 很轻，1 核 1G 能跑，但需要 7×24 在线、有公网 IP、绑域名走 HTTPS（OAuth 回调要 https）。想低成本起一台可以看国产高性价比云服务器，比如雨云：KVM 虚拟化、Debian/Ubuntu 镜像任选，新用户用优惠码 admin01 享五折，入门版折后约 9 元/月，支持 7 天无理由退款。挑机器可参考 VPS 怎么选不踩坑。

我选 Debian 12。前提：你已有一台跑着 Gitea 的服务器（参考雨云搭建 Gitea），且 Gitea 能用 https 域名访问。基础安全按 VPS 到手第一件事做什么走一遍，本文明文默认已开 ufw。Drone 后台走 8080，放行即可。

二、在 Gitea 建 OAuth 应用

Drone 通过 Gitea 的 OAuth 登录并读取仓库，所以先在 Gitea 上建应用：

Gitea「设置 → 应用」→「创建新的 OAuth2 应用程序」。
重定向 URI 填 https://drone.example.com/login。
建好记下 客户端 ID 和 客户端密钥。

三、用 Docker 拉起 Drone

装 Docker：

curl -fsSL https://get.docker.com | sh
systemctl enable --now docker

建目录并写 docker-compose.yml：

mkdir -p /opt/drone && cd /opt/drone

version: "3"
services:
  drone-server:
    image: drone/drone:2
    container_name: drone-server
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - DRONE_GITEA_SERVER=https://git.example.com
      - DRONE_GITEA_CLIENT_ID=填Gitea客户端ID
      - DRONE_GITEA_CLIENT_SECRET=填Gitea客户端密钥
      - DRONE_RPC_SECRET=随机长字符串
      - DRONE_SERVER_HOST=drone.example.com
      - DRONE_SERVER_PROTO=https
      - DRONE_USER_CREATE=username:你的Gitea用户名,admin:true
  drone-runner:
    image: drone/drone-runner-docker:1
    container_name: drone-runner
    restart: unless-stopped
    depends_on:
      - drone-server
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - DRONE_RPC_HOST=drone.example.com
      - DRONE_RPC_PROTO=https
      - DRONE_RPC_SECRET=和上面一致的随机长字符串
      - DRONE_RUNNER_CAPACITY=2

DRONE_RPC_SECRET 在 server 和 runner 两边必须完全一致，用 openssl rand -hex 16 生成。DRONE_USER_CREATE 把你的 Gitea 账号设为 Drone 管理员。启动：

docker compose up -d

四、配 HTTPS 反代

OAuth 回调与 Runner 通信都要 https。用 Nginx 反代 8080：

server {
    listen 80;
    server_name drone.example.com;
    location / { return 301 https://$host$request_uri; }
}
server {
    listen 443 ssl;
    server_name drone.example.com;
    ssl_certificate /etc/letsencrypt/live/drone.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/drone.example.com/privkey.pem;
    client_max_body_size 50m;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

申请证书：certbot --nginx -d drone.example.com。放行端口：

ufw allow 80/tcp
ufw allow 443/tcp
ufw reload

打开 https://drone.example.com，用 Gitea 账号授权登录，左侧能看到 Gitea 里的仓库，点「ACTIVATE」启用。

五、写一条流水线

在仓库根目录加 .drone.yml：

kind: pipeline
type: docker
name: default
steps:
  - name: build
    image: golang:1.22
    commands:
      - go build -o app .
  - name: test
    image: golang:1.22
    commands:
      - go test ./...

推送到 Gitea，Drone 会自动拉起 runner 跑构建。绿了就是过，红了点开看日志。

六、踩过的坑与经验

RPC_SECRET 两边不一致：server 和 runner 的 DRONE_RPC_SECRET 必须相同，否则 runner 连不上 server，流水线永远排队。
Gitea 回调域名要 https：重定向 URI 填 https://drone.example.com/login，且 Gitea 本身也得 https 可访问，否则授权来回跳。
Runner 类型选 docker：drone-runner-docker 用容器跑每一步，干净隔离；记得挂 /var/run/docker.sock，否则 runner 起不了构建容器。
仓库没出现：登录后去 Gitea 看仓库是否「私有」但没给 Drone 授权；点仓库的 ACTIVATE 并在 Drone 里 SYNC 同步一次。
构建容器权限：步骤里写文件到挂载卷时，注意容器内用户 UID 可能和宿主不一致，必要时在 step 加 user: root 或用 chown 修正。
密钥别明文：Token、密码走 Drone 的 Secret（仓库设置里加），.drone.yml 里用 from_secret，别写进仓库。