idoop/docker-nuget-server

docker-nuget-server

镜像概述和主要用途

基于simple-nuget-server的自动构建Docker镜像，用于快速搭建轻量级NuGet服务器，支持NuGet包的存储、管理和分发，适用于私有NuGet包管理场景。

核心功能和特性

• 部署简单，开箱即用，无需复杂配置
• 支持API密钥认证，保障包上传安全
• 可自定义上传文件大小限制、Nginx工作进程数等参数
• 数据持久化设计，通过卷挂载保存数据库和包文件
• 支持自定义服务器域名/IP及端口，适应不同网络环境
• 镜像体积小巧（约200MB），资源占用低

使用场景和适用范围

适用于需要搭建私有NuGet服务器的开发团队或个人，用于管理内部开发的NuGet包，实现团队内部依赖包的共享与版本控制，尤其适合中小企业或项目组的私有包管理需求。

详细使用方法和配置说明

快速启动

Docker命令

shell
docker run -d --name nuget-server -p 80:80 -e NUGET_API_KEY="112233" idoop/docker-nuget-server

Docker Compose配置

yaml
version: '2'
services:
  nuget-server:
    container_name: nuget-server
    image: idoop/docker-nuget-server:latest
    network_mode: "host"
    restart: always
    environment:
      NUGET_API_KEY: "112233"
      UPLOAD_MAX_FILESIZE: "40M"
      
      ## 使用host网络模式时，如需更改服务器暴露端口，可设置SERVER_PORT值
      # SERVER_PORT: "8080"
      
      ## 设置NuGet服务器域名[:端口]，也可使用主机（非容器）IP[:端口]
      ## 例如："192.168.11.22:8080" 或 "nuet.eg.com:8080"
      SERVER_NAME: "nuget.example.com"
      WORKER_PROCESSES: "2"
    volumes:
      - nuget-db:/var/www/simple-nuget-server/db
      - nuget-packagefiles:/var/www/simple-nuget-server/packagefiles
      - nuget-nginx:/etc/nginx
    ulimits:
      nproc: 8096
      nofile:
        soft: 65535
        hard: 65535
volumes:
  nuget-db:
  nuget-packagefiles:
  nuget-nginx:

注意：确保主机源在端口80上可用。

环境变量配置

• NUGET_API_KEY：NuGet API密钥，用于包上传认证，默认值：112233
• UPLOAD_MAX_FILESIZE：上传NuGet包文件的最大大小限制，默认值：20M
• WORKER_PROCESSES：Nginx工作进程数，默认值：1
• WORKER_CONNECTIONS：Nginx工作连接数，默认值：65535
• SERVER_NAME：服务器域名或IP（必填项），默认值：localhost。需设置为服务器可访问的域名或IP，格式示例："192.168.11.22:8080"或"nuet.eg.com:8080"
• SERVER_PORT：服务器端口，默认值：80。注意：使用host网络模式时，可通过此参数修改服务器端口
• BASE_URL：固定基础URL，替代由SERVER_NAME和SERVER_PORT自动生成的URL。适用于容器前存在反向代理的场景

卷挂载

• /var/www/simple-nuget-server/db：SQLite数据库存储路径，用于保存包元数据
• /var/www/simple-nuget-server/packagefiles：NuGet包文件存储路径，用于持久化保存上传的包文件
• /etc/nginx：Nginx配置路径。如需启用HTTPS，需挂载此路径，生成SSL证书/密钥并修改<挂载路径>/conf.d/nuget.conf配置，然后重启容器

测试

1. 下载NuGet命令行工具

推送NuGet包：

shell
nuget push xxx.nupkg -source SERVER_NAME -apikey NUGET_API_KEY

（将xxx.nupkg替换为实际包文件名，SERVER_NAME替换为实际服务器域名/IP）

下载NuGet包：

shell
nuget install xxx -source SERVER_NAME -packagesavemode nupkg

（将xxx替换为包名称，SERVER_NAME替换为实际服务器域名/IP）

已知问题

若未设置SERVER_NAME值，客户端会在本地解析默认服务器名称localhost，可能导致无法访问服务器。