KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

ustcmirror-images

★ 90 Open GitHub ↗

Docker images used by ustcmirror :rocket:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ustcmirror-images

[![Build Status](https://github.com/ustclug/ustcmirror-images/workflows/Build/badge.svg)](https://github.com/ustclug/ustcmirror-images/actions)

## Introduction

These images are designed for mirroring remote directories/repositories in a consistent and portable way. They are used by [ustcmirror (yuki)](https://github.com/ustclug/yuki).

## Quick Start

```sh
docker run --rm \
    -e LOG_ROTATE_CYCLE='5' \
    -e RSYNC_HOST='rsync.alpinelinux.org' \
    -e RSYNC_PATH='alpine/' \
    -e RSYNC_MAXDELETE='10000' \
    -v /var/repos/alpine:/data \
    -v /var/sync-logs/alpine:/log \
    ustcmirror/rsync:latest
```

## Configuration

### Volumes

- `/data`: The mount point of the repository on the host. You can refer to it as environment variable `TO` in your program.
- `/log`: The mount point of the host directory that save logs. You can refer to it as environment variable `LOGDIR` in your program.
   - The image upstream will be written to `$LOGDIR/yuki_upstream.txt`.

### Common Configuration Parameters(AKA environment variables)

Apart from `TO` and `LOGDIR`, these environment variables are common to all images.

| Parameter          | Description                                                                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `DEBUG`            | Set this to `true` to enable debugging.                                                                                                        |
| `BIND_ADDRESS`     | Set the local ip to be bound. Require `--network=host`. (Deprecated -- use Docker network instead. Some programs don't support this parameter) |
| `OWNER`            | Set the uid and gid of the process so that the downloaded files wont get messed up. Defaults to `0:0` (aka root:root).                         |
| `LOG_ROTATE_CYCLE` | Specify how many cycle versions of the logfile to be saved. Set this to `0` will **disable log file**. Defaults to `0` (NO LOG FILE).          |
| `REPO`             | Name of the repository. Required in `archvsync`.                                                                                               |
| `RETRY`            | Times to re-sync if the process exits abnormally. Defaults to `0`.                                                                             |

### aptsync

[![aptsync](https://img.shields.io/docker/image-size/ustcmirror/aptsync/latest)](https://hub.docker.com/r/ustcmirror/aptsync "aptsync")
[![aptsync](https://img.shields.io/docker/pulls/ustcmirror/aptsync)](https://hub.docker.com/r/ustcmirror/aptsync "aptsync")

| Parameter            | Description                                                                                               |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| `APTSYNC_URL`        | Sets the url of upstream.                                                                                 |
| `APTSYNC_NTHREADS`   | Defaults to `20`.                                                                                         |
| `APTSYNC_UNLINK`     | Set this to `1` to remove unneeded files automatically. Defaults to `0`.                                  |
| `APTSYNC_CREATE_DIR` | Set this to `true` to create same directory tree as upstream URL. Defaults to `true`.                     |
| `APTSYNC_DISTS`      | Various distros can be specified in the format `<release> [...]\|<componenet> [...]\|<arch> [...][:...]`. |

Notes: The following `mirror.list`:

```debsources
deb-i386 https://apt.dockerproject.org/repo debian-jessie main
deb-amd64 https://apt.dockerproject.org/repo debian-jessie main
deb-armhf https://apt.dockerproject.org/repo raspbian-jessie main testing
```

is equivalent to the following parameters:

```ini
APTSYNC_URL='https://apt.dockerproject.org/repo'
APTSYNC_DISTS='debian-jessie|main|i386 amd64:raspbian-jessie|main testing|armhf'
```

### apt-sync

[![apt-sync](https://img.shields.io/docker/image-size/ustcmirror/apt-sync/latest)](https://hub.docker.com/r/ustcmirror/apt-sync "apt-sync")
[![apt-sync](https://img.shields.io/docker/pulls/ustcmirror/apt-sync)](https://hub.docker.com/r/ustcmirror/apt-sync "apt-sync")

| Parameter        | Description                                                                                                                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `APTSYNC_URL`    | Sets the url of upstream.                                                                                                       |
| `APTSYNC_UNLINK` | Set this to `1` to remove unneeded files automatically. Defaults to `0`.                                                        |
| `APTSYNC_DISTS`  | Various distros can be specified in the format `<release> [...]\|<componenet> [...]\|<arch> [...]\|<download_dir> [...][:...]`. |

It is almost the same as aptsync. Except that `APTSYNC_DISTS` accepts 4 parameters (rather than 3) for every item.

Consider use `apt-sync` when the upstream replaces packages in-place, as `aptsync` will simply ignore if there're any changes in existed packages.

### archvsync

[![archvsync](https://img.shields.io/docker/image-size/ustcmirror/archvsync/latest)](https://hub.docker.com/r/ustcmirror/archvsync "archvsync")
[![archvsync](https://img.shields.io/docker/pulls/ustcmirror/archvsync)](https://hub.docker.com/r/ustcmirror/archvsync "archvsync")

A.K.A. [ftpsync](https://anonscm.debian.org/cgit/mirror/archvsync.git/)

`archvsync` respects the env vars used in `ftpsync`

| Parameter     | Description                                    |
| ------------- | ---------------------------------------------- |
| `IGNORE_LOCK` | Purge lockfiles at first. Defaults to `false`. |

### crates-io-index

[![crates-io-index](https://img.shields.io/docker/image-size/ustcmirror/crates-io-index/latest)](https://hub.docker.com/r/ustcmirror/crates-io-index "crates-io-index")
[![crates-io-index](https://img.shields.io/docker/pulls/ustcmirror/crates-io-index)](https://hub.docker.com/r/ustcmirror/crates-io-index "crates-io-index")

A dedicated script to sync <https://github.com/rust-lang/crates.io-index>.

| Parameter          | Description                                                                                                                                                                                                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CRATES_PROXY`     | The URL that crates will be redirected to. Defaults to `https://mirrors.ustc.edu.cn/crates.io/api/v1/crates`                                                                                                                                                          |
| `CRATES_GITMSG`    | The commit message of `config.json`. Defaults to `Redirect to USTC Mirrors`                                                                                                                                                                                           |
| `CRATES_GITMAIL`   | `user.email` when committing `config.json`. Defaults to `lug AT ustc.edu.cn`                                                                                                                                                                                          |
| `CRATES_GITNAME`   | `user.name` when committing `config.json`. Defaults to `mirror`                                                                                                                                                                                                       |
| `GEOMETRIC_REPACK` | Backward-compatible alias of `GITSYNC_GEOMETRIC`. Use geometric repacking to speed up repacking (requires `git >= 2.34` on server). See [GitHub Blog: Scaling monorepo maintenance](https://github.blog/2021-04-29-scaling-monorepo-maintenance/). Defaults to false. |

### crates-io

[![crates-io](https://img.shields.io/docker/image-size/ustcmirror/crates-io/latest)](https://hub.docker.com/r/ustcmirror/crates-io "crates-io")
[![crates-io](https://img.shields.io/docker/pulls/ustcmirror/crates-io)](https://hub.docker.com/r/ustcmirror/crates-io "crates-io")

Sync the crates.io git index and incrementally download `.crate` files. Aside from `crates-io-index`, it also uses following env:

| Parameter               | Description                                                                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `CRATES_FILES_UPSTREAM` | Upstream base URL used to download `.crate` files. Defaults to `https://static.crates.io/crates`                   |
| `CRATES_JOBS`           | Number of parallel crate downloads. Defaults to `4`                                                                |
| `CRATES_RETRY`          | Number of retries for each failed crate download. Defaults to `2`                                                  |
| `CRATES_TIMEOUT`        | Timeout in seconds for each crate download request. Defaults to `60`                                               |
| `CRATES_DRY_RUN`        | If set, only compute and print the pending index files and crate entries without downloading or updating state. Defaults to `false` |
| `CRATES_USER_AGENT`     | User-Agent header used for `.crate` downloads. Defaults to `ustcmirror-crates-io/1 (+https://mirrors.ustc.edu.cn)` |

The synced data is stored under `/data/index` (bind mounted crates.io-index repo), `/data/crates`, and `/data/state`. If a previous index commit is no longer available after force-push and git maintenance, the sync falls back to scanning changed index files by mtime.

### debian-cd

[![debian-cd](https://img.shields.io/docker/image-size/ustcmirror/debian-cd/latest)](https://hub.docker.com/r/ustcmirror/debian-cd "debian-cd")
[![debian-cd](https://img.shields.io/docker/pulls/ustcmirror/debian-cd)](https://hub.docker.com/r/ustcmirror/debian-cd "debian-cd")

`debian-cd` accepts the same parameters specified in `debian-cd-mirror.conf`

### docker-ce

[![docker-ce](https://img.shields.io/docker/image-size/ustcmirror/docker-ce/latest)](https://hub.docker.com/r/ustcmirror/docker-ce "docker-ce")
[![docker-ce](https://img.shields.io/docker/pulls/ustcmirror/docker-ce)](https://hub.docker.com/r/ustcmirror/docker-ce "docker-ce")

`docker-ce` accepts following parameters:

| Parameter         | Description                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------- |
| `SYNC_WORKERS`    | Download workers. Defaults to 1.                                                         |
| `SYNC_USER_AGENT` | The user agent of `docker-ce` syncing program. Defaults to `Docker-ce Syncing Tool/1.0`. |
| `SYNC_EXTRA`      | Extra parameters. `--fast-skip` can be set to skip size & timestamp check.               |

### fedora

[![fedora](https://img.shields.io/docker/image-size/ustcmirror/fedora/latest)](https://hub.docker.com/r/ustcmirror/fedora "fedora")
[![fedora](https://img.shields.io/docker/pulls/ustcmirror/fedora)](https://hub.docker.com/r/ustcmirror/fedora "fedora")

Using a modified version of [quick-fedora-mirror](https://pagure.io/quick-fedora-mirror)

See [dist conf](https://pagure.io/quick-fedora-mirror/blob/master/f/quick-fedora-mirror.conf.dist) for parameters meaning.

| Parameter          | Description                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------------- |
| `MODULE`           | fedora module to be mirrored, e.g. fedora-enchilada,fedora-epel                                   |
| `FILTEREXP`        | Extended regular expressions used to exclude entries from the file lists, one expression per line |
| `MAXDELETE`        | Maximum number of file and directory entries that may be deleted in one run. Defaults to `4000`    |
| `RSYNC_EXTRA`      | Additional whitespace-separated options appended to rsync              |
| `VERBOSE`          | log level(0-8), default is 7                                                                      |
| `CHECKIN_SITE`     | see in mirrormanager                                                                              |
| `CHECKIN_PASSWORD` | see in mirrormanager                                                                              |
| `CHECKIN_HOST`     | see in mirrormanager                                                                              |

If the combined number of files and directories scheduled for deletion exceeds
`MAXDELETE`, synchronization first completes its transfers and then deletes at
most `MAXDELETE` entries. It leaves the remaining entries for later runs and
exits with status 25 without updating the mirror timestamp. Files are deleted
before directories, and only empty directories are removed, so recursive
directory deletion cannot bypass the limit.

Different from original version, `FILTEREXP` can be passed as a multiline environment variable. Blank lines and
lines whose first non-whitespace character is `#` are ignored. An entry is
excluded when any expression matches it. These are extended regular expressions,
not ordered rsync include/exclude rules.

The expressions are matched against paths in quick-fedora-mirror's generated
file lists. Paths include the module directory prefix and do not start with `/`;
for example, `fedora/linux/development/...` is used for `fedora-enchilada`. File-list
lines containing files may have a tab and file size after the path.

Example Docker Compose configuration:

# Debug directories at any level
    (^|/)debug(/|$)
```

Filtering happens before quick-fedora-mirror calculates transfers and deletions.
Existing local content matching an expression is therefore considered absent
from the filtered upstream file list and may be deleted during synchronization.

Note: This image is not in use now, as `quick-fedora-mirror` has some mysterious bugs when being used.

### flatpak

[![flatpak](https://img.shields.io/docker/image-size/ustcmirror/flatpak/latest)](https://hub.docker.com/r/ustcmirror/flatpak "flatpak")
[![flatpak](https://img.shields.io/docker/pulls/ustcmirror/flatpak)](https://hub.docker.com/r/ustcmirror/flatpak "flatpak")

A simple sync script to sync necessary metadata for flatpak. **This DOES NOT SYNC ANY BLOB FILES.**

| Parameter    | Description     |
| ------------ | --------------- |
| `USER_AGENT` | user agent used |

### freebsd-pkg

[![freebsd-pkg](https://img.shields.io/docker/image-size/ustcmirror/freebsd-pkg/latest)](https://hub.docker.com/r/ustcmirror/freebsd-pkg "freebsd-pkg")
[![freebsd-pkg](https://img.shields.io/docker/pulls/ustcmirror/freebsd-pkg)](https://hub.docker.com/r/ustcmirror/freebsd-pkg "freebsd-pkg")

| Parameter             | Description                                                                                     |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| `FBSD_PKG_UPSTREAM`   | Set the URL of upstream. Defaults to `http://pkg.freebsd.org`.                                  |
| `FBSD_PKG_JOBS`       | Defaults to `1`.                                                                                |
| `FBSD_PKG_EXCLUDE`    | Exclude ABI by regular expression. Defaults to `^FreeBSD:[89]:`.                                |
| `FBSD_PKG_INDEX_ONLY` | Set to `true` to only sync index files, without downloading package files. Defaults to `false`. |

### freebsd-ports

[![freebsd-ports](https://img.shields.io/docker/image-size/ustcmirror/freebsd-ports/latest)](https://hub.docker.com/r/ustcmirror/freebsd-ports "freebsd-ports")
[![freebsd-ports](https://img.shields.io/docker/pulls/ustcmirror/freebsd-ports)](https://hub.docker.com/r/ustcmirror/freebsd-ports "freebsd-ports")

Notice: BIND_ADDRESS is only added for `curl` in freebsd-ports. Make sure that github.com is accessible under default network settings.

| Parameter                       | Description                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------- |
| `FBSD_PORTS_INDEX_UPSTREAM`     | Set the URL of upstream git index. Defaults to `https://github.com/freebsd/freebsd-ports.git`. |
| `FBSD_PORTS_DISTFILES_UPSTREAM` | Set the URL of upstream distfiles. Defaults to `http://distcache.freebsd.org/ports-distfiles`. |
| `FBSD_PORTS_JOBS`               | Defaults to `1`.                                                                               |

### ghcup

[![ghcup](https://img.shields.io/docker/image-size/ustcmirror/ghcup/latest)](https://hub.docker.com/r/ustcmirror/ghcup "ghcup")
[![ghcup](https://img.shields.io/docker/pulls/ustcmirror/ghcup)](https://hub.docker.com/r/ustcmirror/ghcup "ghcup")

ghcup does not have outstanding configuration options.

### github-release

[![github-release](https://img.shields.io/docker/image-size/ustcmirror/github-release/latest)](https://hub.docker.com/r/ustcmirror/github-release "github-release")
[![github-release](https://img.shields.io/docker/pulls/ustcmirror/github-release)](https://hub.docker.com/r/ustcmirror/github-release "github-release")

| Parameter      | Description                                                                                        |
| -------------- | -------------------------------------------------------------------------------------------------- |
| `UPSTREAM_URL` | GitHub API base URL. Defaults to `https://api.github.com/repos/`.                                  |
| `WORKERS`      | Number of concurrent downloading jobs. Defaults to `8`.                                            |
| `FAST_SKIP`    | Not verify size and timestamp of existing files. Set it to any true string to enable the skipping. |
| `REPOS`        | YAML-format repo list config. See below for details.                                               |

To specified the repo list to sync, you can:

- Read-only bind mount a YAML file into the container at `/repos.yaml`. See the [example](github-release/examples/repos.yaml).
- Pass the YAML-format repo list string as `REPOS` env.

### gitsync

[![gitsync](https://img.shields.io/docker/image-size/ustcmirror/gitsync/latest)](https://hub.docker.com/r/ustcmirror/gitsync "gitsync")
[![gitsync](https://img.shields.io/docker/pulls/ustcmirror/gitsync)](https://hub.docker.com/r/ustcmirror/gitsync "gitsync")

| Parameter                              | Description                                                                                                                                                   |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GITSYNC_URL`                          | Sets the url of upstream.                                                                                                                                     |
| `GITSYNC_BRANCH`                       | Defaults to `master:master`.                                                                                                                                  |
| `GITSYNC_REMOTE`                       | Defaults to `origin`.                                                                                                                                         |
| `GITSYNC_BITMAP`                       | Enable bitmap index. Defaults to `true`.                                                                                                                      |
| `GITSYNC_MIRROR`                       | A shortcut to sync all branches and tags as if `GITSYNC_BRANCH='+refs/heads/*:refs/heads/*'`. `GITSYNC_BRANCH` is ignored when it is set.                     |
| `GITSYNC_CHECKOUT`                     | Checkout instead of bare cloning. Defaults to `false`.                                                                                                        |
| `GITSYNC_TREELESS`                     | Use [treeless clone](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) to save disk space. Defaults to `false`.           |
| `GITSYNC_GEOMETRIC`                    | Use [geometric repacking](https://github.blog/2021-04-29-scaling-monorepo-maintenance/) to speed up repacking. Requires `GITSYNC_BITMAP`. Defaults to `true`. |
| `GITSYNC_MAINTENANCE_INTERVAL_SECONDS` | Time interval of running `run_periodic_maintenance`. Defaults to 604800 (1 week).                                                                             |
| `GITSYNC_REFLOG_EXPIRE`                | Value passed to both `git reflog expire --expire` and `--expire-unreachable`. Defaults to `all`.                                                              |
| `GITSYNC_POST_FETCH_HOOK`              | Executable hook run after fetch/reset and before maintenance/repack. Useful for repository-specific post-processing. Defaults to unset.                       |

### google-repo

[![google-repo](https://img.shields.io/docker/image-size/ustcmirror/google-repo/latest)](https://hub.docker.com/r/ustcmirror/google-repo "google-repo")
[![google-repo](https://img.shields.io/docker/pulls/ustcmirror/google-repo)](https://hub.docker.com/r/ustcmirror/google-repo "google-repo")

A script for syncing projects (especially AOSP) using Google's `repo` tool.

### gsutil-rsync

[![gsutil-rsync](https://img.shields.io/docker/image-size/ustcmirror/gsutil-rsync/latest)](https://hub.docker.com/r/ustcmirror/gsutil-rsync "gsutil-rsync")
[![gsutil-rsync](https://img.shields.io/docker/pulls/ustcmirror/gsutil-rsync)](https://hub.docker.com/r/ustcmirror/gsutil-rsync "gsutil-rsync")

| Parameter    | Description                                    |
| ------------ | ---------------------------------------------- |
| `GS_URL`     | Sets the url of upstream. e.g. `gs://golang/`. |
| `GS_EXCLUDE` | Files to be excluded. Defaults to empty.       |

### hackage

[![hackage](https://img.shields.io/docker/image-size/ustcmirror/hackage/latest)](https://hub.docker.com/r/ustcmirror/hackage "hackage")
[![hackage](https://img.shields.io/docker/pulls/ustcmirror/hackage)](https://hub.docker.com/r/ustcmirror/hackage "hackage")

| Parameter          | Description                                                        |
| ------------------ | ------------------------------------------------------------------ |
| `HACKAGE_BASE_URL` | Set the URL of upstream. Defaults to `https://hackage.haskell.org` |

### homebrew-bottles

[![homebrew-bottles](https://img.shields.io/docker/image-size/ustcmirror/homebrew-bottles/latest)](https://hub.docker.com/r/ustcmirror/homebrew-bottles "homebrew-bottles")
[![homebrew-bottles](https://img.shields.io/docker/pulls/ustcmirror/homebrew-bottles)](https://hub.docker.com/r/ustcmirror/homebrew-bottles "homebrew-bottles")

| Parameter               | Description                                     |
| ----------------------- | ----------------------------------------------- |
| `HOMEBREW_BOTTLES_JOBS` | Parallel jobs. Defaults to `1`                  |
| `BREW_SH_BIND_ADDRESS`  | Bind address for accessing formulae.brew.sh API |

### julia-storage

[![julia-storage](https://img.shields.io/docker/image-size/ustcmirror/julia-storage/latest)](https://hub.docker.com/r/ustcmirror/julia-storage "julia-storage")
[![julia-storage](https://img.shields.io/docker/pulls/ustcmirror/julia-storage)](https://hub.docker.com/r/ustcmirror/julia-storage "julia-storage")

A new solution to sync Julia general registry (using `StorageMirrorServer.jl`). No parameters needed.

### lftpsync

[![lftpsync](https://img.shields.io/docker/image-size/ustcmirror/lftpsync/latest)](https://hub.docker.com/r/ustcmirror/lftpsync "lftpsync")
[![lftpsync](https://img.shields.io/docker/pulls/ustcmirror/lftpsync)](https://hub.docker.com/r/ustcmirror/lftpsync "lftpsync")

| Parameter                 | Description                                                                                                                |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `LFTPSYNC_HOST`           | The hostname of the remote server.                                                                                         |
| `LFTPSYNC_PATH`           | The destination path on the remote server.                                                                                 |
| `LFTPSYNC_EXCLUDE`        | Files to be excluded. Defaults to `-X .~tmp~/`.                                                                            |
| `LFTPSYNC_JOBS`           | Defaults to `$(getconf _NPROCESSORS_ONLN)`.                                                                                |
| `LFTPSYNC_MIRROR_ARGS`    | Parameters for mirror command. Defaults to `--verbose --use-cache -aec`                                                    |
| `LFTPSYNC_EXTRA_COMMANDS` | Extra commands for lftp (ie. `set sftp:connect-program "ssh -axi <keyfile>";`). Will be executed before opening connection |

### misc

[![misc](https://img.shields.io/docker/image-size/ustcmirror/misc/latest)](https://hub.docker.com/r/ustcmirror/misc "misc")
[![misc](https://img.shields.io/docker/pulls/ustcmirror/misc)](https://hub.docker.com/r/ustcmirror/misc "misc")

| Parameter        | Description                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| `DOWNLOAD_LINKS` | Files to be downloaded by wget. Format is `filename.sh http://example.com/filename.sh` seperates by newlines |

Download seperate, small files inconvenient for other sync containers.

Example of `DOWNLOAD_LINKS`:

```bash
brew-install.sh https://github.com/Homebrew/install/raw/HEAD/install.sh
rustup-install.sh https://sh.rustup.rs/
```

### nix-channels

[![nix-channels](https://img.shields.io/docker/image-size/ustcmirror/nix-channels/latest)](https://hub.docker.com/r/ustcmirror/nix-channels "nix-channels")
[![nix-channels](https://img.shields.io/docker/pulls/ustcmirror/nix-channels)](https://hub.docker.com/r/ustcmirror/nix-channels "nix-channels")

| Parameter                  | Description                                                                                                                                                       |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NIX_MIRROR_UPSTREAM`      | Main page of Nix channels. No trailing slash. Defaults to [`https://nixos.org/channels`](https://nixos.org/channels)                                              |
| `NIX_MIRROR_BASE_URL`      | The root URL this mirror will be served at. No trailing slash. Defaults to [`https://mirrors.ustc.edu.cn/nix-channels`](https://mirrors.ustc.edu.cn/nix-channels) |
| `NIX_MIRROR_PATH_BATCH`    | Number of paths to pass to `nix` each time, to avoid `E2BIG`. Defaults to `8192`, which is about 1/4 of the 2M `ARG_MAX`.                                         |
| `NIX_MIRROR_THREADS`       | Number of threads to use to download in parallel. Defaults to 10                                                                                                  |
| `NIX_MIRROR_RETAIN_DAYS`   | Days to consider old versions as reachable. Defaults to 30. (The newest version of a release is always reachable)                                                 |
| `NIX_MIRROR_DELETE_OLD`    | Whether to actually delete files in garbage collection. Set to `1` to delete and `0` to not delete. Defaults to `1`                                               |
| `NIX_MIRROR_RELEASES_ONLY` | Don't download binary blobs. Defaults to 0 (false)                                                                                                                |

### pypi

[![pypi](https://img.shields.io/docker/image-size/ustcmirror/pypi/latest)](https://hub.docker.com/r/ustcmirror/pypi "pypi")
[![pypi](https://img.shields.io/docker/pulls/ustcmirror/pypi)](https://hub.docker.com/r/ustcmirror/pypi "pypi")

Sync PyPI with official mirror client [bandersnatch](https://github.com/pypa/bandersnatch). Note that this image is not actively maintained. It's suggested to use [shadowmire](#shadowmire) instead.

| Parameter                    | Description         |
| ---------------------------- | ------------------- |
| `BANDERSNATCH_WORKERS`       | Defaults to `3`.    |
| `BANDERSNATCH_STOP_ON_ERROR` | Defaults to `true`. |
| `BANDERSNATCH_TIMEOUT`       | Defaults to `20`.   |

### pytorch

[![pytorch](https://img.shields.io/docker/image-size/ustcmirror/pytorch/latest)](https://hub.docker.com/r/ustcmirror/pytorch "pytorch")
[![pytorch](https://img.shields.io/docker/pulls/ustcmirror/pytorch)](https://hub.docker.com/r/ustcmirror/pytorch "pytorch")

Sync PyTorch packages from <https://download.pytorch.org/>.

| Parameter          | Description                                                                              |
| ------------------ | ---------------------------------------------------------------------------------------- |
| `DRY_RUN`          | Set to `1` to skip writing files. Defaults to `0`.                                       |
| `JOBS`             | Number of concurrent downloads. Defaults to `2`.                                         |
| `TIMEOUT`          | HTTP timeout in seconds. Defaults to `30`.                                               |
| `URLBASE`          | URL prefix used when rewriting HTML links. Defaults to `/pytorch/`.                      |
| `GET_ALL`          | Set to `1` to use `published_versions.json` instead of `releases.json`. Defaults to `0`. |
| `CUSTOM_ENDPOINTS` | Comma-separated list of extra endpoints, e.g. `https://download.pytorch.org/whl/xpu`.    |
| `NO_NIGHTLY`       | Set to `1` to skip nightly builds. Defaults to `1`.                                      |

### rclone

[![rclone](https://img.shields.io/docker/image-size/ustcmirror/rclone/latest)](https://hub.docker.com/r/ustcmirror/rclone "rclone")
[![rclone](https://img.shields.io/docker/pulls/ustcmirror/rclone)](https://hub.docker.com/r/ustcmirror/rclone "rclone")

| Parameter                | Description                                                                        |
| ------------------------ | ---------------------------------------------------------------------------------- |
| `RCLONE_PATH`            | The destination path. Note that the rclone remote has been hard-coded as `remote`. |
| `RCLONE_EXTRA`           | Extra options passed to `rclone sync`. Defaults to empty.                          |
| `RCLONE_CHECKERS`        | Set the number of checkers. Defaults to `$(getconf _NPROCESSORS_ONLN)`.            |
| `RCLONE_TRANSFERS`       | Set the number of file transfers. Defaults to `$(getconf _NPROCESSORS_ONLN)`.      |
| `RCLONE_CONFIG_REMOTE_*` | Set config file options.                                                           |

ref:

- [rclone environment variables](https://rclone.org/docs/#environment-variables)
- [rclone-sync manual](https://rclone.org/commands/rclone_sync/)

### rsync

[![rsync](https://img.shields.io/docker/image-size/ustcmirror/rsync/latest)](https://hub.docker.com/r/ustcmirror/rsync "rsync")
[![rsync](https://img.shields.io/docker/pulls/ustcmirror/rsync)](https://hub.docker.com/r/ustcmirror/rsync "rsync")

| Parameter               | Description                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------- |
| `RSYNC_HOST`            | The hostname of the remote server.                                                                |
| `RSYNC_USER`            | (Optional) No defaults.                                                                           |
| `RSYNC_PASSWORD`        | (Optional) No defaults.                                                                           |
| `RSYNC_PATH`            | The destination path on the remote server.                                                        |
| `RSYNC_BW`              | Bandwidth limit. Defaults to `0`.                                                                 |
| `RSYNC_EXTRA`           | Extra options. Defaults to empty.                                                                 |
| `RSYNC_EXCLUDE`         | Files to be excluded. Defaults to `--exclude .~tmp~/`.                                            |
| `RSYNC_FILTER`          | Filter rules. More convenient for larger lists.                                                   |
| `RSYNC_BLKSIZE`         | Defaults to `8192`.                                                                               |
| `RSYNC_TIMEOUT`         | Defaults to `14400`.                                                                              |
| `RSYNC_SPARSE`          | Defaults to `true`.                                                                               |
| `RSYNC_DELAY_UPDATES`   | Defaults to `true`.                                                                               |
| `RSYNC_DELETE_DELAY`    | Defaults to `true`. Use `--delete-delay` rather than `--delete`                                   |
| `RSYNC_DELETE_EXCLUDED` | Defaults to `true`. Use `--delete-excluded` to delete excluded files.                             |
| `RSYNC_MAXDELETE`       | Maximum number of files that can be removed. Defaults to `4000`.                                  |
| `RSYNC_RSH`             | Specify the remote shell, e.g. `ssh -i /path/to/key`.                                             |
| `RSYNC_NO_DELETE`       | Defaults to `false`. Set to `true` to disable all deletion arguments.                             |
| `RSYNC_SSL`             | Defaults to `false`. Set to `true` to use `rsync-ssl`. `BIND_ADDRESS` is not respected when true. |

### rubygems / rubygems-dynamic

[![rubygems](https://img.shields.io/docker/image-size/ustcmirror/rubygems/latest)](https://hub.docker.com/r/ustcmirror/rubygems "rubygems")
[![rubygems](https://img.shields.io/docker/pulls/ustcmirror/rubygems)](https://hub.docker.com/r/ustcmirror/rubygems "rubygems")

| Parameter  | Description                        |
| ---------- | ---------------------------------- |
| `UPSTREAM` | Defaults to `http://rubygems.org`. |

### rustup

[![rustup](https://img.shields.io/docker/image-size/ustcmirror/rustup/latest)](https://hub.docker.com/r/ustcmirror/rustup "rustup")
[![rustup](https://img.shields.io/docker/pulls/ustcmirror/rustup/latest)](https://hub.docker.com/r/ustcmirror/rustup "rustup")

This image is based on [rustup-mirror](https://github.com/jiegec/rustup-mirror).

| Parameter  | Description                                 |
| ---------- | ------------------------------------------- |
| `UPSTREAM` | Defaults to `https://static.rust-lang.org/` |
| `GC`       | Defaults to `1`                             |
| `TARGETS`  | Defaults to `x86_64-unknown-linux-gnu`      |
| `URL`      | Defaults to `http://127.0.0.1:8000/`        |

### shadowmire

[![shadowmire](https://img.shields.io/docker/image-size/ustcmirror/shadowmire/latest)](https://hub.docker.com/r/ustcmirror/shadowmire "shadowmire")
[![shadowmire](https://img.shields.io/docker/pulls/ustcmirror/shadowmire)](https://hub.docker.com/r/ustcmirror/shadowmire "shadowmire")

[Shadowmire](https://github.com/taoky/shadowmire/) syncs PyPI (or plain HTTP(S) PyPI mirrors using Shadowmire) with a lightweight and easy approach.

| Parameter        | Description                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------- |
| `UPSTREAM`       | Defaults to `https://pypi.org`.                                                                |
| `INDEX_ONLY`     | Don't download package blobs. Defaults to `false`.                                             |
| `EXCLUDE`        | A list of `--exclude` and `--prerelease-exclude`.                                              |
| `USE_PYPI_INDEX` | Still use PyPI package listing when `UPSTREAM` is not `https://pypi.org`. Defaults to `false`. |

### stackage

[![stackage](https://img.shields.io/docker/image-size/ustcmirror/stackage/latest)](https://hub.docker.com/r/ustcmirror/stackage "stackage")
[![stackage](https://img.shields.io/docker/pulls/ustcmirror/stackage)](https://hub.docker.com/r/ustcmirror/stackage "stackage")

Stackage doesn't need to specify upstream.

### tsumugu

[![tsumugu](https://img.shields.io/docker/image-size/ustcmirror/tsumugu/latest)](https://hub.docker.com/r/ustcmirror/tsumugu "tsumugu")
[![tsumugu](https://img.shields.io/docker/pulls/ustcmirror/tsumugu)](https://hub.docker.com/r/ustcmirror/tsumugu "tsumugu")

An alternative HTTP(S) syncing tool, replacing `rclone` and `lftp` in some cases. See [usage](https://github.com/taoky/tsumugu#usage).

| Parameter               | Description                                                                                         |
| ----------------------- | --------------------------------------------------------------------------------------------------- |
| `UPSTREAM`              | Sets the url of upstream.                                                                           |
| `TSUMUGU_MAXDELETE`     | Maximum number of files that can be removed. Defaults to `1000`.                                    |
| `TSUMUGU_TIMEZONEFILE`  | The file URL for guessing remote server timezone.                                                   |
| `TSUMUGU_EXCLUDE`       | Files to be excluded. Value example: `"--exclude '^temp'"`                                          |
| `TSUMUGU_USERAGENT`     | The user agent of `tsumugu` syncing program. Defaults to `Tsumugu Syncing Tool/$(tsumugu_version)`. |
| `TSUMUGU_PARSER`        | HTML parser used to parse index page. Defaults to `nginx`.                                          |
| `TSUMUGU_THREADS`       | Number of threads to use to download in parallel. Defaults to 2.                                    |
| `TSUMUGU_EXTRA`         | Extra options. Defaults to empty.                                                                   |
| `TSUMUGU_DELAY_UPDATES` | Delay updates until end of transfer. Defaults to `metadata`. Set to `all` to delay all files.       |

### winget-source

[![winget-source](https://img.shields.io/docker/image-size/ustcmirror/winget-source/latest)](https://hub.docker.com/r/ustcmirror/winget-source "winget-source")
[![winget-source](https://img.shields.io/docker/pulls/ustcmirror/winget-source)](https://hub.docker.com/r/ustcmirror/winget-source "winget-source")

A handy tool to sync pre-indexed [Windows Package Manager](https://github.com/microsoft/winget-cli) (aka. WinGet) sources.

| Parameter             | Description                                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `WINGET_FORCE_SYNC`   | Force syncs everything against the upstream. Defaults to `false`.                                                        |
| `WINGET_REPO_URL`     | Sets the URL of upstream. Defaults to [`https://cdn.winget.microsoft.com/cache`](https://cdn.winget.microsoft.com/cache) |
| `WINGET_REPO_JOBS`    | Parallel jobs. Defaults to 8.                                                                                            |
| `WINGET_REPO_EXCLUDE` | Packages to be excluded. Value example: `Google.Chrome,Microsoft.Edge`                                                   |

### yukina

[![yukina](https://img.shields.io/docker/image-size/ustcmirror/yukina/latest)](https://hub.docker.com/r/ustcmirror/yukina "yukina")
[![yukina](https://img.shields.io/docker/pulls/ustcmirror/yukina)](https://hub.docker.com/r/ustcmirror/yukina "yukina")

[yukina](https://github.com/taoky/yukina) analyses given nginx log, and maintains binary blobs (which does not modify once exist) state under given size limit.
Usually this shall be used with another sync container that only downloads index files.

Note that you shall bind necessary nginx log to `/nginx-log/` when syncing.

| Parameter           | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `UPSTREAM`          | Sets the url of upstream.                                    |
| `YUKINA_SIZE_LIMIT` | The size limit of binary blobs. Defaults to `512g`.          |
| `YUKINA_FILTER`     | Accepts regex to filter out binary blobs. Defaults to empty. |
| `YUKINA_EXTRA`      | Extra options. Defaults to empty.                            |
| `YUKINA_REPO`       | The repository name. Defaults to `$REPO`.                    |

### yum-sync

[![yum-sync](https://img.shields.io/docker/image-size/ustcmirror/yum-sync/latest)](https://hub.docker.com/r/ustcmirror/yum-sync "yum-sync")
[![yum-sync](https://img.shields.io/docker/pulls/ustcmirror/yum-sync)](https://hub.docker.com/r/ustcmirror/yum-sync "yum-sync")

| Parameter                   | Description                                                                                                                           |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `YUMSYNC_URL`               | Sets the url of upstream.                                                                                                             |
| `YUMSYNC_DISTS`             | Various distros can be specified in the format `<release> [...]\|<component> [...]\|<arch> [...]\|<reponame>\|<download_dir> [:...]`. |
| `YUMSYNC_DOWNLOAD_REPODATA` | Whether to download repodata files instead of generating them by `createrepo`                                                         |

`yum-sync` tries to imitate the parameters of `aptsync`, and it supports the following substitution rule for `YUMSYNC_URL` and `<reponame>` & `<download_dir>` in `YUMSYNC_DISTS`:

- `@{arch}`: Architecture (x86_64, armhf, ...)
- `@{os_ver}`: OS version (6-8, ...)
- `@{comp}`: The `<component>` in `YUMSYNC_DISTS`

`yum-sync.py` is modified to get the same directory structure as upstream when syncing. And `<reponame>` should be named the same as the directory containing `repodata` dir.

Notes:

The following repo configuration:

```ini
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el$releasever-$basearch
```

translates to:

```ini
YUMSYNC_URL='https://packages.cloud.google.com/yum/repos/kubernetes-el@{os_ver}-@{arch}'
YUMSYNC_DISTS='6-7|kubernetes|x86_64,aarch64,armhfp,ppc64le,s390x|kubernetes-el@{os_ver}-@{arch}|/yum/repos/kubernetes-el@{os_ver}-@{arch}'
```

And the following:

```ini
[mysql80-community]
name=MySQL 8.0 Community Server
baseurl=http://repo.mysql.com/yum/mysql-8.0-community/el/$releasever/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-mysql

[mysql57-community]
name=MySQL 5.7 Community Server
baseurl=http://repo.mysql.com/yum/mysql-5.7-community/el/$releasever/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-mysql
```

translates to:

```ini
YUMSYNC_URL='https://repo.mysql.com/yum/@{comp}/el/@{os_ver}/@{arch}/'
YUMSYNC_DISTS='6-8|mysql-8.0-community,mysql-5.7-community|aarch64,i386,x86_64|@{arch}|/yum/@{comp}/el/@{os_ver}/@{arch}/'
```

## License

Specially, contents of folder `apt-sync`, `yum-sync`, `github-release`, `docker-ce` and the generated container image from them are under GPLv3 license, as it uses code from <https://github.com/tuna/tunasync-scripts>.

ustcmirror-images

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README