A new Community-Written Solution for setting up a community mirror #536

SavaLione commented 2025年09月09日 13:32:46 +02:00 (Migrated from github.com)

This adds a new new community-written solution for setting up a community mirror.

Go Mirror Zig is a simple way to set up a Zig community mirror.
It is lightweight, distributed as a single binary and supports automatic ACME challenges.

Features:

• Efficient caching: Downloads files from an upstream server once and serves them from a local cache for all subsequent requests.
• Automatic TLS: Full support for ACME (Let's Encrypt) to automatically obtain and renew TLS certificates.
• Secure by default: Supports HTTPS and automatic redirection from HTTP to HTTPS.
• Standalone binary: Compiles to a single, dependency-free binary for easy deployment.
• Configurable: All settings are manageable via command-line flags, including ports, cache directories, and upstream URL.
• Path correctness: Caches files using the official Zig directory layout (/download/<version>/ and /builds/).

The solution source code: https://github.com/SavaLione/go-mirror-zig/

Thanks!

This adds a new new community-written solution for setting up a community mirror. Go Mirror Zig is a simple way to set up a Zig community mirror. It is lightweight, distributed as a single binary and supports automatic ACME challenges. Features: * Efficient caching: Downloads files from an upstream server once and serves them from a local cache for all subsequent requests. * Automatic TLS: Full support for ACME (Let's Encrypt) to automatically obtain and renew TLS certificates. * Secure by default: Supports HTTPS and automatic redirection from HTTP to HTTPS. * Standalone binary: Compiles to a single, dependency-free binary for easy deployment. * Configurable: All settings are manageable via command-line flags, including ports, cache directories, and upstream URL. * Path correctness: Caches files using the official Zig directory layout (`/download/<version>/` and `/builds/`). The solution source code: https://github.com/SavaLione/go-mirror-zig/ Thanks!

mlugg commented 2026年03月12日 16:53:32 +01:00 (Migrated from github.com)

I'd prefer not to add this until there's a mirror using it (like you were trying to add in #533) just so that I know it works. I'll leave this open for now, but if you decide not to open a follow-up to #533, would you mind closing this? Either way, thank you! :)

I'd prefer not to add this until there's a mirror using it (like you were trying to add in #533) just so that I know it works. I'll leave this open for now, but if you decide *not* to open a follow-up to #533, would you mind closing this? Either way, thank you! :)

SavaLione commented 2026年03月13日 23:36:55 +01:00 (Migrated from github.com)

Hi @mlugg ,

I've created a new PR that adds a new community mirror (#592).
It uses the newest version of this solution (v1.1.0)

I've also added some new features:

• You can now customize or remove the index.html root page, which is useful for those who prefer not to display branding.
• The application can now periodically remove cached dev builds based on a configured interval. This solves the issue mentioned in (#591), where the mirror went down due to significant disk space usage (~120GB of builds per server).

If you have any questions or suggestions, I'd be happy to answer them.

Thanks!

Hi @mlugg , I've created a new PR that adds a new community mirror ([#592](https://github.com/ziglang/www.ziglang.org/pull/592)). It uses the newest version of this solution (`v1.1.0`) I've also added some new features: * You can now customize or remove the `index.html` root page, which is useful for those who prefer not to display branding. * The application can now periodically remove cached dev builds based on a configured interval. This solves the issue mentioned in ([#591](https://github.com/ziglang/www.ziglang.org/pull/591)), where the mirror went down due to significant disk space usage (~120GB of builds per server). If you have any questions or suggestions, I'd be happy to answer them. Thanks!

mlugg commented 2026年03月15日 15:10:02 +01:00 (Migrated from github.com)

Thank you!

Thank you!