twoProxy:基于 Node.js + Express 的加速服务解决方案项目

可用于 GitHub、Docker 及通用文件加速,提供前端界面、后端 API、用户系统和临时邮箱等完整功能,支持仓库搜索、文件下载加速、镜像代理及 API Key 程序化访问。【此简介由AI生成】

Branch1Tags0
FilesLast commitLast update
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago

YLJD Mirror 加速站 🚀

License: MIT GitHub Stars

面向国内用户的 GitHub / Docker / 通用文件加速 完整解决方案。提供前端界面、后端 API、用户系统、临时邮箱等完整功能。

🌐 在线演示

访问地址:https://mirror.yljdteam.com/


✨ 功能特性

🔧 核心功能

GitHub 加速

  • ✅ 仓库搜索和浏览
  • ✅ 文件下载加速
  • ✅ Release 软件包加速
  • ✅ Git Clone 镜像加速
  • ✅ API 请求代理

Docker 加速

  • ✅ Docker Hub 镜像代理
  • ✅ 镜像搜索功能
  • ✅ Registry 认证支持
  • ✅ 流量统计和限制

文件下载加速

  • ✅ 任意 HTTPS 直链加速
  • ✅ 脚本自动改写(如 Ollama 安装脚本)
  • ✅ 自动 URL 转换
  • ✅ 一键复制加速命令
  • ✅ API Key 程序化访问(Python/命令行)

🎯 扩展功能

用户系统

  • ✅ 用户注册/登录
  • ✅ 邀请码系统
  • ✅ 团队成员管理
  • ✅ 个人子域名支持
  • ✅ API Key 管理(已启用文件加速下载 API)

临时邮箱服务

  • ✅ 一键生成临时邮箱
  • ✅ 实时接收邮件
  • ✅ 验证码自动识别
  • ✅ 历史邮箱记录
  • ✅ 多域名支持(logincursor.xyz 等)
  • ✅ 支持 Cursor 注册

管理功能

  • ✅ 用户管理后台
  • ✅ 流量统计
  • ✅ 邀请码管理
  • ✅ 感谢名单展示

📂 项目结构

twoProxy/
├── index.html              # 主页(SPA 入口)
├── user/                   # 用户中心
│   ├── index.html         # 用户登录/注册页面
│   └── user.js            # 用户逻辑
├── admin/                  # 管理后台
│   ├── index.html         # 管理员界面
│   └── admin.js           # 管理逻辑
├── css/                    # 样式文件
│   └── style.css          # 玻璃态 UI 风格
├── js/                     # 前端脚本
│   └── app.js             # 主应用逻辑(路由、API)
├── api/                    # 后端 API(Node.js + Express)
│   ├── src/
│   │   ├── app.js         # Express 服务器
│   │   ├── routes/        # API 路由
│   │   ├── config/        # 配置管理
│   │   ├── lib/           # 数据库和 Redis
│   │   └── scripts/       # 数据库初始化
│   └── package.json       # 依赖管理
├── deploy/                 # 部署配置
│   ├── nginx-hongkong.conf.example        # 香港服务器 Nginx
│   ├── nginx-guangzhou.conf.example       # 广州服务器 Nginx
│   ├── guangzhou-github-proxy.py          # GitHub 代理服务
│   ├── guangzhou-github-proxy.service     # systemd 服务
│   ├── guangzhou-requirements.txt         # Python 依赖
│   └── GUANGZHOU_DEPLOYMENT.md            # 广州服务器部署文档
├── scripts/                # 自动化脚本
│   ├── deploy.sh          # 一键部署脚本
│   ├── backup.sh          # 自动备份脚本
│   ├── restore.sh         # 数据恢复脚本
│   ├── migrate-all.sh     # 一键迁移脚本(推荐)
│   ├── migrate-backup.sh  # 备份旧服务器
│   ├── migrate-restore.sh # 恢复到新服务器
│   └── migrate-verify.sh  # 验证迁移结果
├── cloudflare-email-worker.js  # Cloudflare Worker(邮箱服务)
├── sponsors.json.example       # 感谢名单数据示例
├── examples/                   # API 使用示例
│   ├── python_download.py     # Python 完整示例
│   ├── python_download_simple.py  # Python 简化示例
│   ├── test_api.py            # API 测试脚本
│   └── README.md              # 示例使用文档
├── DEPLOYMENT.md               # 完整部署文档
├── TWO_SERVER_MIGRATION.md     # 双服务器迁移指南
├── MIGRATION_CHECKLIST.md      # 迁移检查清单
├── API_KEY_USAGE.md            # API Key 使用说明
└── README.md                   # 项目说明(本文件)

🚀 快速开始

方式一:单服务器部署(推荐新手)

# 1. 克隆仓库
git clone https://github.com/violettoolssite/twoProxy.git
cd twoProxy

# 2. 运行一键部署脚本
sudo bash scripts/deploy.sh

# 3. 按照提示配置域名和 SSL 证书
sudo certbot --nginx -d your-domain.com

# 4. 访问网站
# 打开浏览器访问 https://your-domain.com

方式二:双服务器部署(推荐生产环境)

适用于需要更高性能和可靠性的场景。

香港服务器(主站)

git clone https://github.com/violettoolssite/twoProxy.git
cd twoProxy
sudo bash scripts/deploy.sh

广州服务器(加速节点)

git clone https://github.com/violettoolssite/twoProxy.git
cd twoProxy

# 安装 Python 依赖
sudo pip3 install -r deploy/guangzhou-requirements.txt

# 部署 GitHub 代理服务
sudo mkdir -p /opt/github-proxy
sudo cp deploy/guangzhou-github-proxy.py /opt/github-proxy/app.py
sudo cp deploy/guangzhou-github-proxy.service /etc/systemd/system/github-proxy.service

# 启动服务
sudo systemctl daemon-reload
sudo systemctl start github-proxy
sudo systemctl enable github-proxy

# 配置 Nginx
sudo cp deploy/nginx-guangzhou.conf.example /etc/nginx/sites-enabled/violetteam.conf
sudo nginx -t && sudo systemctl reload nginx

详细部署步骤请参考:


🔄 服务器迁移

⚡ 一键迁移(推荐)

如果需要将现有服务迁移到新服务器,使用我们的一键迁移脚本:

cd /var/www/mirror/scripts
bash migrate-all.sh

交互式向导将引导您完成:

  1. 选择迁移模式(单服务器/双服务器/合并部署)
  2. 自动备份旧服务器数据
  3. 传输并恢复到新服务器
  4. 自动验证迁移结果

📋 迁移脚本

脚本 功能 使用场景
migrate-all.sh 一键完整迁移 最简单,推荐使用
migrate-backup.sh 备份旧服务器 手动分步操作
migrate-restore.sh 恢复到新服务器 手动分步操作
migrate-verify.sh 验证迁移结果 测试新服务器

📖 详细迁移文档


📚 文档索引

本项目提供完整的文档体系,涵盖部署、开发、功能和管理等各个方面。

🚀 部署文档

文档 说明 适用场景
DEPLOYMENT.md 完整部署指南 单服务器从零部署
TWO_SERVER_MIGRATION.md 双服务器部署和迁移 生产环境高可用部署
MIGRATION_QUICK_START.md ⚡ 快速迁移指南 服务器迁移必读
MIGRATION_CHECKLIST.md 迁移检查清单 服务器迁移前核对
CDN_CONFIGURATION.md ☁️ CDN边缘加速配置 提升全球访问速度
deploy/GUANGZHOU_DEPLOYMENT.md 广州服务器专用文档 加速节点部署

📧 临时邮箱文档

文档 说明 适用对象
临时邮箱集成说明 前端使用指南 普通用户
Cloudflare Worker 配置 邮件服务后端部署 开发者/管理员

📱 短信接码文档

文档 说明 适用对象
SMS_INTEGRATION.md 短信接码功能集成文档 开发者
SMS_USAGE_LIMIT.md 使用次数限制功能说明 开发者/管理员
SMS_AUTO_RELEASE.md 自动释放机制详解 开发者/管理员
ADMIN_SMS_GUIDE.md 管理员SMS管理指南 管理员

🔧 开发文档

文档 说明 适用对象
api/README.md 后端API文档 后端开发者
browser-extension/README.md 浏览器扩展说明 前端开发者
API_KEY_USAGE.md 🔑 API Key 使用说明 开发者/API用户
examples/README.md 🐍 Python API 示例代码 Python开发者

📖 快速导航


🏗️ 部署架构

单服务器架构

服务器 (your-domain.com)
├── Nginx (80/443)
│   ├── 前端静态页面
│   ├── API 反向代理 → 127.0.0.1:3000
│   ├── GitHub 代理
│   ├── Docker Hub 代理
│   └── 文件下载代理
├── Node.js API (3000)
│   ├── 用户认证
│   ├── 流量统计
│   └── 内部接口
├── MySQL
│   └── 用户数据、流量统计
└── Redis
    └── 会话缓存

双服务器架构(推荐)

香港服务器 (mirror.yljdteam.com)
├── 完整的 Mirror 加速站
├── 用户系统和管理后台
├── 临时邮箱服务(Cloudflare Worker)
└── 基础代理功能

广州服务器 (violetteam.cloud)
├── GitHub 文件加速(Python + Flask)
├── Docker Registry 镜像(腾讯云)
└── 专用加速节点

优点:

  • ✅ 高可用性:服务隔离,互不影响
  • ✅ 高性能:专用节点,负载分散
  • ✅ 易扩展:可独立扩容
  • ✅ 故障隔离:单点故障不影响整体

📖 使用说明

GitHub 加速

方式 1:搜索仓库

  1. 访问主页,进入 GitHub 模块
  2. 搜索仓库名(如 ollama)
  3. 点击结果查看加速链接

方式 2:直接转换 URL

# 原始 GitHub 文件 URL
https://github.com/ollama/ollama/releases/download/v0.1.0/ollama-linux-amd64

# 加速后的 URL
https://mirror.yljdteam.com/file/https/github.com/ollama/ollama/releases/download/v0.1.0/ollama-linux-amd64

方式 3:Git Clone 加速

# 使用镜像站 Clone
git clone https://mirror.yljdteam.com/owner/repo.git

Docker 加速

配置镜像源

# 编辑 Docker 配置
sudo nano /etc/docker/daemon.json

# 添加镜像源
{
  "registry-mirrors": [
    "https://mirror.yljdteam.com"
  ]
}

# 重启 Docker
sudo systemctl restart docker

单次使用

docker pull mirror.yljdteam.com/library/nginx:latest

临时邮箱使用

  1. 访问 https://mirror.yljdteam.com/#/email
  2. 点击"生成邮箱"或"随机生成"
  3. 使用生成的邮箱地址注册服务
  4. 点击"查看邮件"接收邮件
  5. 支持自动识别验证码并一键复制

支持的域名:

  • logincursor.xyz - 支持 Cursor 注册 ✅
  • email.logincursor.xyz
  • vip.logincursor.xyz
  • qxfy.store
  • email.qxfy.store
  • kami666.xyz
  • 等多个域名

⚙️ 配置说明

环境变量配置

复制示例配置文件:

cp api/src/config/env.example.js api/.env

编辑 .env 文件,配置以下关键项:

# JWT 密钥(必须修改)
JWT_SECRET=your-random-secret-here

# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=mirror
DB_PASSWORD=your-db-password
DB_NAME=mirror

# 域名配置
DOMAIN=mirror.yljdteam.com
BASE_URL=https://mirror.yljdteam.com

# 邮件配置(可选,用于找回密码)
SMTP_HOST=mail.example.com
SMTP_PORT=465
SMTP_USER=noreply@example.com
SMTP_PASS=your-email-password

Nginx 配置

配置文件位于 deploy/ 目录:

  • nginx-hongkong.conf.example - 香港服务器配置
  • nginx-guangzhou.conf.example - 广州服务器配置

根据实际情况修改:

  • server_name - 你的域名
  • ssl_certificate - SSL 证书路径
  • proxy_pass - 上游服务地址

🔒 安全建议

  1. 修改默认密钥

    • 生成强随机的 JWT_SECRET
    • 使用强密码保护数据库
  2. 配置防火墙

    sudo ufw enable
    sudo ufw allow 22/tcp
    sudo ufw allow 80/tcp
    sudo ufw allow 443/tcp
    
  3. 启用 HTTPS

    sudo certbot --nginx -d your-domain.com
    
  4. 限制 API 访问速率

    • 已内置 rate limiting
    • 可在 Nginx 配置中调整
  5. 定期备份

    # 设置定时任务
    crontab -e
    # 添加: 0 2 * * * /var/www/mirror/scripts/backup.sh
    

🛠️ 开发和调试

前端开发

# 启动简单 HTTP 服务器
python3 -m http.server 8080

# 或使用 Node.js
npx http-server -p 8080

后端开发

cd api

# 安装依赖
npm install

# 开发模式(自动重启)
npm run dev

# 生产模式
npm start

数据库初始化

cd api

# 初始化数据库表
npm run init-db

📊 监控和维护

查看服务状态

# PM2 状态
pm2 status

# 查看日志
pm2 logs mirror-api

# Nginx 日志
sudo tail -f /var/log/nginx/access.log
sudo tail -f /var/log/nginx/error.log

性能监控

# 实时监控
pm2 monit

# 系统资源
htop

备份和恢复

# 备份
bash scripts/backup.sh

# 恢复
bash scripts/restore.sh BACKUP_DATE

💖 为爱发电

本项目完全免费开源,采用"为爱发电"模式运营。

为什么选择为爱发电?

我们相信:

  • 💡 知识应该自由传播 - 技术不应该被金钱束缚
  • 🌍 互联网应该开放共享 - 每个人都应该平等访问信息
  • ❤️ 社区的力量是无穷的 - 你的支持是我们前进的动力

项目运营成本

为了维持项目运营,我们每月需要支付:

  • 🖥️ 服务器费用:香港服务器 + 广州服务器(约 ¥300-500/月)
  • 🌐 域名费用:多个域名续费(约 ¥100-200/年)
  • ⚡ CDN 流量:Cloudflare 等(约 ¥100-300/月)
  • 📧 邮件服务:临时邮箱域名和服务(约 ¥50-100/月)
  • ⏰ 开发时间:功能开发、维护、优化(无价)

月度总成本约:¥600-1000

如何支持我们?

💰 资金支持

如果这个项目帮助了您,欢迎赞助支持:

微信赞赏码
微信赞赏
支付宝收款码
支付宝

哪怕只有 ¥10,也是对我们最大的鼓励! 🙏

每一笔赞助都会被用于:

  • 服务器续费和升级
  • 购买更多域名提供服务
  • 开发新功能
  • 改进用户体验

🌐 域名赞助

如果您有闲置域名愿意免费提供给本站:

  • 📧 邮箱后缀域名:扩展临时邮箱服务可用域名
  • 🚀 加速节点域名:提供更多加速入口

联系方式:QQ: 1494458927

⭐ 其他支持方式

  • Star 本项目 - 让更多人看到
  • 分享给朋友 - 帮助更多人解决问题
  • 提交 PR - 改进代码和文档
  • 报告 Bug - 帮助我们发现问题
  • 提出建议 - 告诉我们你的需求

感谢名单

所有赞助者都会被记录在 感谢名单 中!

访问 https://mirror.yljdteam.com/#/sponsors 查看完整名单。

感谢每一位支持者!你们的支持是我们继续前进的动力! ❤️


🤝 贡献指南

欢迎贡献代码、文档或建议!

提交 Issue

  • 🐛 Bug 反馈:详细描述问题和复现步骤
  • 💡 功能建议:说明需求和使用场景
  • 📖 文档改进:指出不清楚或错误的地方

提交 Pull Request

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

代码规范

  • 使用清晰的变量和函数命名
  • 添加必要的注释
  • 遵循现有代码风格
  • 测试你的改动

📄 许可证

本项目采用 MIT License 开源协议。

这意味着:

  • ✅ 可以自由使用、修改、分发
  • ✅ 可以用于商业项目
  • ✅ 可以二次开发
  • ⚠️ 需要保留版权声明
  • ⚠️ 作者不承担任何责任

🙏 致谢

感谢以下开源项目:


📞 联系我们


🛠️ 服务支持

感谢以下优秀的服务提供商为本站提供基础设施支持!


Cloudflare

Cloudflare

CDN · Workers
邮件路由



Tencent Cloud

Tencent Cloud

腾讯云服务器
CDN加速



Alibaba Cloud

Alibaba Cloud

阿里云服务器
云计算



Google Cloud

Google Cloud

云基础设施
全球网络



Spaceship

Spaceship

域名注册
DNS服务



好助云

好助云

短信接码平台
验证码服务


本项目的稳定运行离不开上述服务商的优质基础设施支持。
我们使用多云架构确保服务的高可用性和最佳性能。

⚠️ 免责声明

  1. 本项目仅供学习和研究使用
  2. 使用本项目产生的任何问题,作者不承担责任
  3. 请遵守相关法律法规,合理使用代理服务
  4. 请勿用于任何违法用途

如果这个项目帮助了您,请给一个 ⭐️ Star!

如果您愿意支持我们,欢迎赞助!

Made with ❤️ by YLJD Team

Introduction

可用于 GitHub、Docker 及通用文件加速,提供前端界面、后端 API、用户系统和临时邮箱等完整功能,支持仓库搜索、文件下载加速、镜像代理及 API Key 程序化访问。【此简介由AI生成】

Customize your domain