philiplehmann/nx-cache-server
philiplehmann
一个轻量级、高性能的Nx缓存服务器。
1 次收藏下载次数: 0状态：社区镜像维护者：philiplehmann仓库类型：镜像最近更新：4 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Nx缓存服务器
一个轻量级、自托管的Nx远程缓存服务器，具有S3兼容的存储后端。
链接
- GitHub: https://github.com/philiplehmann/nx-cache-server
- Docker Hub: https://hub.docker.com/r/philiplehmann/nx-cache-server
快速开始
创建config.yaml文件：
yamlport: 3000 buckets: - name: minio-bucket bucketName: nx-cache accessKeyId: minioadmin secretAccessKey: minioadmin region: us-east-1 endpointUrl: http://localhost:9000 forcePathStyle: true serviceAccessTokens: - name: local-dev bucket: minio-bucket prefix: /local accessToken: your-secure-bearer-token
使用Docker运行：
bashdocker run -d \ -p 3000:3000 \ -v $(pwd)/config.yaml:/nx-cache-server/config.yaml:ro \ docker.xuanyuan.run/philiplehmann/nx-cache-server:2.2.2
或使用Docker Compose：
yamlversion: '3.8' services: nx-cache-server: image: docker.xuanyuan.run/philiplehmann/nx-cache-server:2.2.2 ports: - "3000:3000" volumes: - ./config.yaml:/nx-cache-server/config.yaml:ro restart: unless-stopped
与Nx配合使用
设置环境变量：
bashexport NX_SELF_HOSTED_REMOTE_CACHE_SERVER=http://localhost:3000 export NX_SELF_HOSTED_REMOTE_CACHE_ACCESS_TOKEN=your-bearer-token
详情请参见https://nx.dev/docs/guides/tasks--caching/self-hosted-caching#usage-notes。
示例
完整示例（包括MinIO、AWS S3、多存储桶等）请参见：
- https://github.com/philiplehmann/nx-cache-server/tree/master/examples
配置
存储桶（Buckets）
| 字段 | 是否必填 | 描述 |
|---|---|---|
name | 是 | 唯一标识符 |
bucketName | 是 | S3存储桶名称 |
region | 否 | AWS区域（省略时自动发现） |
accessKeyId | 否 | AWS访问密钥（或使用accessKeyIdEnv） |
secretAccessKey | 否 | AWS密钥（或使用secretAccessKeyEnv） |
endpointUrl | 否 | 自定义S3端点（适用于MinIO等） |
forcePathStyle | 否 | MinIO必填（默认：false） |
timeout | 否 | S3超时时间（秒）（默认：30） |
服务访问令牌（Service Access Tokens）
| 字段 | 是否必填 | 描述 |
|---|---|---|
name | 是 | 令牌标识符 |
bucket | 是 | 引用存储桶名称 |
prefix | 是 | S3键前缀（根目录使用""） |
accessToken | 是* | Bearer令牌（或使用accessTokenEnv） |
*需提供accessToken或accessTokenEnv
多架构支持
支持linux/amd64和linux/arm64架构。
其他资源
- https://github.com/philiplehmann/nx-cache-server/blob/master/examples/config.example.yaml
- https://nx.dev/docs/guides/tasks--caching/self-hosted-caching
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 nx-cache-server 镜像标签
docker pull docker.xuanyuan.run/philiplehmann/nx-cache-server:<标签>
DockerHub 原生拉取命令
docker pull philiplehmann/nx-cache-server:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"