LightMirrors

LightMirrors是一个开源的缓存镜像站服务，用于加速软件包下载和镜像拉取。目前支持DockerHub、PyPI、PyTorch、NPM等镜像缓存服务。

Quick Start

Prerequisites

docker + docker-compose.
一个域名，设置 *.yourdomain 的A记录指向您服务器的IP.
- *.local.homeinfra.org 默认指向 127.0.0.1，本地测试可以直接使用。
代理服务器（如有必要）.

如果需要使用HTTPS，可以在外层新增一个HTTP网关（如Caddy），请参考后续章节。

QuickStart


cp .env.example .env
docker-compose up

Deployment

修改 .env 文件，设置下列参数：

BASE_DOMAIN: 基础域名，如 local.homeinfra.org，镜像站将会使用 *.local.homeinfra.org 的子域名。
RPC_SECRET：Aria2的RPC密钥。
all_proxy：代理服务器地址，如有必要。
SCHEME：http 或 https。

如果您需要HTTPS，请确保docker-compose.yml文件中开放443端口，并使用cloudflare 相关的Caddyfile和Dockerfile.

docker-compose up

测试命令：

docker pull docker.local.homeinfra.org/alpine
pip3 download -i http://pypi.local.homeinfra.org/simple/ jinja2 --trusted-host pypi.local.homeinfra.org
pip3 download -i http://torch.local.homeinfra.org/whl/ torch --trusted-host torch.local.homeinfra.org

Design

LightMirrors依赖于两个组件：

aria2 : 下载器与管理UI。
mirrors: 镜像HTTP服务器，根据不同域名转发请求到不同模块。
- Aria2Ng
- PyPI
- DockerHub
- ...

Test

假设我们的域名为 local.homeinfra.org

subdomain	source	test command	test command (http)
pypi	https://pypi.org	`pip3 download -i https://pypi.local.homeinfra.org/simple jinja2`	`pip3 download -i http://pypi.local.homeinfra.org/simple jinja2 --trusted-host pypi.local.homeinfra.org`
torch	https://download.pytorch.org	`pip3 download -i https://torch.local.homeinfra.org/whl/ torch`	`pip3 download -i http://torch.local.homeinfra.org/whl/ torch --trusted-host torch.local.homeinfra.org`
dockerhub	https://registry-1.docker.io/v2	`docker pull docker.local.homeinfra.org/alpine`	`docker pull docker.local.homeinfra.org/alpine`

HTTPS

在 .env 中配置 SCHEME=https 与 CLOUDFLARE_DNS_API_TOKEN。本项目提供了一个基于Cloudflare DNS的Caddyfile和Dockerfile，可以直接使用。如果您希望使用其他DNS Provider，请自行修改。

配置完成后，执行下列命令：

docker-compose -f docker-compose-caddy.yml up

3.7 KiB Raw Blame History Unescape Escape