Linux Nixery Nix

无需 Dockerfile，打造你的专属即时容器镜像--自建 Nixery 私有服务器

Posted by Mike on 2024-07-22

自建一个 Nixery 实例可以让你在本地或私有服务器上运行 Nixery 服务，从而避免公共服务的不稳定性。以下是一个基本的步骤指南，帮助你在本地或服务器上部署 Nixery。

1. 准备环境

确保你的系统已经安装了以下软件：

  • Nix
  • Docker
  • Git

Docker 和 Git 属于基础软件，就不再展开讲解安装部分了。Nix 安装你可以参考 Nix 官方文档 进行安装。

2. 克隆 Nixery 仓库

首先，你需要克隆 Nixery 的代码仓库：

1
2
$ git clone https://code.tvl.fyi/depot.git:/tools/nixery.git nixery
$ cd nixery

3. 构建和运行 Nixery

使用 Nix 构建 Nixery 镜像：

1
$ nix-build -A nixery-image

构建完成后，你会在 result 目录中得到一个 Docker 镜像。

1
2
3
4
# 加载镜像
$ docker load < result
# 按你的实际 tag 修改下面的值
$ docker tag nixery:bbgi5sfqwpp6fsd36ccqw9yi0vykdkz3 nixery:latest

4. 配置 Nixery

Nixery 支持多种配置选项，可以通过环境变量进行设置。以下是一些常见的配置选项：

  • PORT：Nixery 应监听的 HTTP 端口
  • NIXERY_CHANNEL：用于构建 Nixery 的 Nix/NixOS 通道名称。
  • NIXERY_PKGS_REPO：包含软件包集的 git 仓库的 URL（使用本地配置的 SSH/git 凭据）
  • NIXERY_PKGS_PATH：包含用于构建的 Nix 软件包集的本地文件系统路径
  • NIXERY_STORAGE_BACKEND：要使用的后端存储类型，目前支持的值为 gcs（谷歌云存储）和 filesystem。
  • NIX_TIMEOUT：允许任何 Nix 生成器运行的秒数（默认值为 60）
  • NIX_POPULARITY_URL：指向包含软件包集受欢迎程度数据的文件的 URL（参见 popcount/）。

存储

Nixery 支持多种不同的存储后端，构建缓存和图像层都保存在这些后端中，并从这些后端提供服务。

目前可用的存储后端有谷歌云端存储和本地文件系统。

在谷歌云存储中，通过将客户端重定向到存储桶来提供镜像。存储在文件系统中的镜像图层则直接从本地磁盘提供。

要配置存储后端，必须设置这些额外的配置环境变量：

  • GCS_BUCKET：要使用的谷歌云存储桶名称（gcs 必填）
  • GOOGLE_APPLICATION_CREDENTIALS：指向 GCP 服务帐户 JSON 密钥的路径（GCS 可选）
  • STORAGE_PATH：用于存储和提供数据的文件夹的路径（本地存储路径）

如果 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为服务账户密钥，Nixery 将使用该密钥为存储桶中的图层创建签名 URL。这样就可以从存储桶中提供图层，而无需将其公开。

如果未设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量，则会重定向到 storage.googleapis.com，这意味着底层的存储桶对象需要可公开访问。

5. 运行 Nixery 容器

  • 使用本地文件系统作为存储后端
1
2
3
4
5
6
7
8
$ docker run --name nixery -d -p 8080:8080 \
  -e PORT=8080 \
  -e NIXERY_STORAGE_BACKEND=filesystem \
  -e STORAGE_PATH=/opt/data/store \
  -e NIXERY_PKGS_REPO=https://github.com/NixOS/nixpkgs \
  -e NIXERY_CHANNEL=nixos-unstable \
  -v ./data:/opt/data/  \
  nixery:latest
  • 使用 GCS 作为存储后端

如果你想使用 Google Cloud Storage (GCS) 作为存储后端，可以按以下步骤操作：

1
2
3
4
5
6
7
8
$ docker run --name nixery -d -p 8080:8080 \
  -e PORT=8080 \
  -e NIXERY_STORAGE_BACKEND=gcs \
  -e GCS_BUCKET=your-gcs-bucket-name \
  -e NIXERY_PKGS_REPO=https://github.com/NixOS/nixpkgs \
  -e NIXERY_CHANNEL=nixos-unstable \
  -v ./data:/opt/data/  \  
  nixery
  • 访问自建的 Nixery

现在，你应该可以通过 http://localhost:8080 访问你的 Nixery 实例。

6. 使用自建的 Nixery 拉取镜像

启动 Nixery 容器后，你可以像使用公共 Nixery 服务一样使用你自建的 Nixery 实例。例如：

1
2
$ docker run --rm -it localhost:8080/shell/btop
$ docker run --rm -it IP:8080/shell/git/btop/curl

7. 进一步配置

你可以根据需要进一步配置你的 Nixery 实例，例如：

  • 使用 Nginx 或其他反向代理服务器来处理请求

以下是一个使用 Nginx 作为反向代理的示例配置：

1
2
3
4
5
6
7
8
9
10
11
12
server {
    listen 80;
    server_name your.domain.com;

    location / {
        proxy_pass http://localhost:8080;
        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-Proto $scheme;
    }
}
  • 使用 HTTP 访问 Nixery 实例

自建的 Nixery 实例默认没有支持 HTTPS。你如果不想配置 HTTPS，请确保 Docker Daemon 允许使用 HTTP 连接。你可以通过以下步骤进行配置：

  1. 编辑 Docker Daemon 的配置文件（通常位于 /etc/docker/daemon.json）并添加不安全的注册表地址
1
2
3
{
  "insecure-registries": ["10.1.2.3:8080"]
}

注：10.1.2.3:8080 是你的 Nixery 实例的 IP 地址和端口号，请按实际情况修改。

  1. 重启 Docker 服务
1
$ sudo systemctl restart docker

8. 监控和日志

为了保证服务的稳定运行，你可能需要设置监控和日志系统。例如，可以使用 Prometheus 和 Grafana 来监控 Nixery 的性能。

通过这些步骤，你能够成功自建一个 Nixery 实例并根据需要进行配置和扩展。如果你在过程中遇到任何问题，可以参考 Nixery 的文档或社区支持。

9. 彩蛋

自建 Nixery 私有服务器最大的技术难点是需要 Nix 环境。你如果不想扯腾 Nix 环境，可以直接使用我构建好的 Nixery 的镜像。

你只需要在公众号后台直接回复「Nixery」，即可免费获取 Nixery 镜像下载地址。

FEATURED TAGS
Linux Nixery Nix
FRIENDS