Docker部署Github Proxy代理，加速GitHub克隆下载

Junyang2023-11-06 15:45

文章已同步至【个人博客】，欢迎访问【我的主页】😃

文章地址：blog.fanjunyang.zone/archives/do...

前言

国内网络环境一言难尽，在访问 GitHub 的时候要么不能访问，要么下载速度极慢，毫无体验可言。

无论是在本地还是在国内服务器中都不能直接访问拉取 GitHub 的代码。

除了挂 代理，本篇文章给大家分享另外一种方式，可以自建一个 GitHub 的代理服务来使用

不想自建的话，大家可以直接使用我部署的 免费 API 代理服务，[戳我](#不想自建的话，大家可以直接使用我部署的 免费 API 代理服务，戳我查看怎么使用 "#%E4%BD%BF%E7%94%A8")查看怎么使用

有两种部署方式：

  1. 通过免费的 Cloudflare Worker 部署（免费版每天有 10 万次免费请求，并且有每分钟1000次请求的限制）
  2. 需要一台国外服务器，用 Docker 方式部署

相关链接

搭建方式

Cloudflare worker部署

首页：workers.cloudflare.com

注册，登陆，Start building，取一个子域名，Create a Worker。

复制 下面代码 到左侧代码框，Save and deploy。如果正常，右侧应显示首页。

javascript 复制代码 
'use strict'

/**
 * static files (404.html, sw.js, conf.js)
 */
const ASSET_URL = 'https://hunshcn.github.io/gh-proxy/'
// 前缀，如果自定义路由为example.com/gh/*，将PREFIX改为 '/gh/'，注意，少一个杠都会错！
const PREFIX = '/'
// 分支文件使用jsDelivr镜像的开关，0为关闭，默认关闭
const Config = {
    jsdelivr: 0
}

const whiteList = [] // 白名单，路径里面有包含字符的才会通过，e.g. ['/username/']

/** @type {RequestInit} */
const PREFLIGHT_INIT = {
    status: 204,
    headers: new Headers({
        'access-control-allow-origin': '*',
        'access-control-allow-methods': 'GET,POST,PUT,PATCH,TRACE,DELETE,HEAD,OPTIONS',
        'access-control-max-age': '1728000',
    }),
}


const exp1 = /^(?:https?:\/\/)?github\.com\/.+?\/.+?\/(?:releases|archive)\/.*$/i
const exp2 = /^(?:https?:\/\/)?github\.com\/.+?\/.+?\/(?:blob|raw)\/.*$/i
const exp3 = /^(?:https?:\/\/)?github\.com\/.+?\/.+?\/(?:info|git-).*$/i
const exp4 = /^(?:https?:\/\/)?raw\.(?:githubusercontent|github)\.com\/.+?\/.+?\/.+?\/.+$/i
const exp5 = /^(?:https?:\/\/)?gist\.(?:githubusercontent|github)\.com\/.+?\/.+?\/.+$/i
const exp6 = /^(?:https?:\/\/)?github\.com\/.+?\/.+?\/tags.*$/i

/**
 * @param {any} body
 * @param {number} status
 * @param {Object<string, string>} headers
 */
function makeRes(body, status = 200, headers = {}) {
    headers['access-control-allow-origin'] = '*'
    return new Response(body, {status, headers})
}


/**
 * @param {string} urlStr
 */
function newUrl(urlStr) {
    try {
        return new URL(urlStr)
    } catch (err) {
        return null
    }
}


addEventListener('fetch', e => {
    const ret = fetchHandler(e)
        .catch(err => makeRes('cfworker error:\n' + err.stack, 502))
    e.respondWith(ret)
})


function checkUrl(u) {
    for (let i of [exp1, exp2, exp3, exp4, exp5, exp6]) {
        if (u.search(i) === 0) {
            return true
        }
    }
    return false
}

/**
 * @param {FetchEvent} e
 */
async function fetchHandler(e) {
    const req = e.request
    const urlStr = req.url
    const urlObj = new URL(urlStr)
    let path = urlObj.searchParams.get('q')
    if (path) {
        return Response.redirect('https://' + urlObj.host + PREFIX + path, 301)
    }
    // cfworker 会把路径中的 `//` 合并成 `/`
    path = urlObj.href.substr(urlObj.origin.length + PREFIX.length).replace(/^https?:\/+/, 'https://')
    if (path.search(exp1) === 0 || path.search(exp5) === 0 || path.search(exp6) === 0 || path.search(exp3) === 0 || path.search(exp4) === 0) {
        return httpHandler(req, path)
    } else if (path.search(exp2) === 0) {
        if (Config.jsdelivr) {
            const newUrl = path.replace('/blob/', '@').replace(/^(?:https?:\/\/)?github\.com/, 'https://cdn.jsdelivr.net/gh')
            return Response.redirect(newUrl, 302)
        } else {
            path = path.replace('/blob/', '/raw/')
            return httpHandler(req, path)
        }
    } else if (path.search(exp4) === 0) {
        const newUrl = path.replace(/(?<=com\/.+?\/.+?)\/(.+?\/)/, '@$1').replace(/^(?:https?:\/\/)?raw\.(?:githubusercontent|github)\.com/, 'https://cdn.jsdelivr.net/gh')
        return Response.redirect(newUrl, 302)
    } else {
        return fetch(ASSET_URL + path)
    }
}


/**
 * @param {Request} req
 * @param {string} pathname
 */
function httpHandler(req, pathname) {
    const reqHdrRaw = req.headers

    // preflight
    if (req.method === 'OPTIONS' &&
        reqHdrRaw.has('access-control-request-headers')
    ) {
        return new Response(null, PREFLIGHT_INIT)
    }

    const reqHdrNew = new Headers(reqHdrRaw)

    let urlStr = pathname
    let flag = !Boolean(whiteList.length)
    for (let i of whiteList) {
        if (urlStr.includes(i)) {
            flag = true
            break
        }
    }
    if (!flag) {
        return new Response("blocked", {status: 403})
    }
    if (urlStr.startsWith('github')) {
        urlStr = 'https://' + urlStr
    }
    const urlObj = newUrl(urlStr)

    /** @type {RequestInit} */
    const reqInit = {
        method: req.method,
        headers: reqHdrNew,
        redirect: 'manual',
        body: req.body
    }
    return proxy(urlObj, reqInit)
}


/**
 *
 * @param {URL} urlObj
 * @param {RequestInit} reqInit
 */
async function proxy(urlObj, reqInit) {
    const res = await fetch(urlObj.href, reqInit)
    const resHdrOld = res.headers
    const resHdrNew = new Headers(resHdrOld)

    const status = res.status

    if (resHdrNew.has('location')) {
        let _location = resHdrNew.get('location')
        if (checkUrl(_location))
            resHdrNew.set('location', PREFIX + _location)
        else {
            reqInit.redirect = 'follow'
            return proxy(newUrl(_location), reqInit)
        }
    }
    resHdrNew.set('access-control-expose-headers', '*')
    resHdrNew.set('access-control-allow-origin', '*')

    resHdrNew.delete('content-security-policy')
    resHdrNew.delete('content-security-policy-report-only')
    resHdrNew.delete('clear-site-data')

    return new Response(res.body, {
        status,
        headers: resHdrNew,
    })
}

ASSET_URL 是静态资源的 url（实际上就是现在显示出来的那个输入框单页面）

PREFIX 是前缀，默认（根路径情况为 / ），如果自定义路由为 example.com/gh/*，请将PREFIX改为 /gh/，注意，少一个杠都会错！

Docker命令方式

安装完 Docker 环境后，可以直接执行命令把 Docker 容器跑起来（注意端口换成宿主机上未被使用的端口）：

css 复制代码 
docker run -d --name gh-proxy-py -p 9011:80 --restart always hunsh/gh-proxy-py

然后运行命令 docker ps 能查看到启动的容器了。

Docker Compose方式

创建目录

bash 复制代码 
mkdir -p /root/docker_data/github_proxy
bash 复制代码 
cd /root/docker_data/github_proxy

创建yml文件

在 /root/docker_data/github_proxy 文件夹下面新建 docker-compose.yml 文件如下：

yaml 复制代码 
version: '3.3'
services:
    gh-proxy-py:
        container_name: gh-proxy-py
        ports:
            - '9011:80' # 左侧端口换成宿主机上未被占用的端口
        restart: always
        image: 'hunsh/gh-proxy-py'

运行yml文件

进入 /root/docker_data/github_proxy 文件夹下面，运行命令：

复制代码 
docker-compose up -d

或者在任意文件夹下面，运行命令：

bash 复制代码 
docker-compose -f /root/docker_data/github_proxy/docker-compose.yml up -d

然后运行命令 docker ps 能查看到启动的容器了。

配置反向代理

Docker 容器运行成功后，可以用 【IP】+【端口】进行访问和使用（服务器需要暴露对应的端口号）。

但是建议用域名的方式进行访问，域名配置下 DNS 解析，Nginx 反向代理配置示例如下：

ini 复制代码 
server {
  server_name api-ghp.example.com;
  listen 443 ssl http2;
  ssl_certificate /xxx/xxx/xxx.cer;
  ssl_certificate_key /xxx/xxx/xxx.key;
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
  listen 80;
  if ($scheme = http) {
    return 301 https://$host:443$request_uri;
  }
  location / {
    proxy_pass http://172.17.0.1:9100;
    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-Host $http_host;
    proxy_set_header X-Forwarded-Port $server_port;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_redirect http:// https://;
  }
}

访问

可以使用 【IP】 + 【端口】或者 【域名】的方式进行访问，如果出现下图，即代表成功：

使用

免费 API 代理服务

部署成功后，可以直接使用 站点，或者在我们拉取代码的时候，直接在 GitHub 地址前面加上你的服务器地址即可。

例如你的服务器地址为：http://1.2.3.4:9011，或者域名为：https://api-ghp.example.com，那么你可以这样输入：

  • http://1.2.3.4:9011/https://github.com/junyangfan/jy-ui.git
  • https://api-ghp.example.com/https://github.com/junyangfan/jy-ui.git
相关推荐
xiezhr3 分钟前
别再被VO、BO、PO、DTO、DO绕晕！今天用一段代码把它们讲透
java·后端·spring
Pitayafruit16 分钟前
Spring AI 进阶之路04：集成 SearXNG 实现联网搜索
spring boot·后端·ai编程
风象南19 分钟前
SpringBoot 自研「轻量级 API 防火墙」：单机内嵌，支持在线配置
后端
Victor35636 分钟前
Redis（14）Redis的列表（List）类型有哪些常用命令？
后端
Victor35636 分钟前
Redis（15）Redis的集合（Set）类型有哪些常用命令？
后端
卷福同学38 分钟前
来上海三个月，我在马路边上遇到了阿里前同事...
java·后端
海绵不是宝宝8179 小时前
连接远程服务器上的 jupyter notebook，解放本地电脑
服务器·jupyter·github
bobz9659 小时前
小语言模型是真正的未来
后端
DevYK10 小时前
企业级 Agent 开发实战(一) LangGraph 快速入门
后端·llm·agent
一只叫煤球的猫11 小时前
🕰 一个案例带你彻底搞懂延迟双删
java·后端·面试
热门推荐
01UV安装并设置国内源02DeepSeek更新！速览DeepSeek V3.1新特性03Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code04KGG转MP3工具|非KGM文件|解密音频05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接06【2025.08.06最新版】Android Studio下载、安装及配置记录（自动下载sdk）072025最新国内服务器可用docker源仓库地址大全（2025年8月更新）08阿里开源首个图像生成基础模型——Qwen-Image本地部署教程，超强中文渲染能力刷新SOTA！09NVIDIA显卡驱动、CUDA、cuDNN 和 TensorRT 版本匹配指南10TRAE 规则（Rules）配置指南：个人习惯、团队规范与最佳实践