lsiodev/nntp2nntp

linuxserver/nntp2nntp

镜像概述和主要用途

https://github.com/linuxserver/nntp2nntp 是一个NNTP代理工具，允许从多个系统使用同一NNTP账户，每个系统可配置独立的用户名和密码。它完全支持SSL，还可以通过SSL证书限制对代理的访问。该代理工具简单且运行高效，主要用于局域网环境，使所有用户的NNTP应用程序能够共享一组内部凭据，实现上游账户的集中管理（如更改提供商、服务器或线程限制只需修改一次全局配置）。

警告

尽管我们未发现nntp2nntp存在安全问题，但该项目的https://github.com/linuxserver/nntp2nntp自2015年8月6日以来未收到任何更新，可能已被永久放弃。因此，我们强烈建议不要将此应用程序暴露在公网环境中。如果必须公开，应将其他安全层和SSL视为绝对最低要求。

核心功能和特性

• 支持多系统共享单个NNTP账户，每个系统可配置独立用户名和密码
• 完全支持SSL加密连接
• 可通过SSL证书限制访问权限
• 轻量级设计，运行高效
• 支持用户ID（PUID）和组ID（PGID）映射，避免权限问题
• 基于Alpine基础镜像，体积小，更新频繁

支持的架构

该镜像利用Docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/nntp2nntp:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构的镜像。

支持的架构如下：

应用设置

1. 编辑配置文件 config/nntp2nntp.conf，填入上游NNTP提供商详细信息并修改本地用户
2. 新用户密码可通过密码哈希生成器创建：

   bash
   docker exec -it nntp2nntp /usr/bin/nntp2nntp.py pass
   

3. 输入所需密码，将生成的哈希字符串复制到 /config/nntp2nntp.conf 中相应的用户行

示例（用户名为Dave，密码为password）：

Dave    = 5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8

使用方法和配置说明

Docker Compose（推荐）

yaml
---
version: "2.1"
services:
  nntp2nntp:
    image: docker.xuanyuan.run/linuxserver/nntp2nntp:latest
    container_name: nntp2nntp
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - <path to data>:/config
    ports:
      - 1563:1563
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=nntp2nntp \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 1563:1563 \
  -v <path docker.xuanyuan.run/to data>:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/nntp2nntp:latest

参数说明

容器镜像通过运行时传递的参数进行配置，格式为<外部>:<内部>。

环境变量（Docker Secrets）

可通过特殊前缀FILE__从文件设置任何环境变量。例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

这将根据/run/secrets/mysecretpassword文件的内容设置PASSWORD环境变量。

Umask设置

所有镜像都支持通过可选参数-e UMASK=022覆盖容器内服务的默认umask设置。请注意，umask不是chmod，它基于其值减去权限而非添加。

用户/组标识符

使用卷（-v标志）时，主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的任何卷目录都由您指定的相同用户拥有。

使用id user命令可获取您的PUID和PGID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

我们发布了各种https://github.com/linuxserver/docker-mods以启用容器内的额外功能。上述动态徽章可访问此镜像可用的Mods列表以及可应用于任何LinuxServer.io镜像的通用Mods。

支持信息

• 容器运行时的Shell访问：docker exec -it nntp2nntp /bin/bash
• 实时监控容器日志：docker logs -f nntp2nntp
• 容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' nntp2nntp
• 镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/nntp2nntp:latest

更新信息

大多数镜像都是静态的、版本化的，需要更新镜像并重新创建容器以更新内部应用。除某些例外（如nextcloud、plex），我们不建议或支持在容器内更新应用。

通过Docker Compose更新

• 更新所有镜像：docker-compose pull
• 更新单个镜像：docker-compose pull nntp2nntp
• 更新容器：docker-compose up -d 或 docker-compose up -d nntp2nntp
• 移除旧镜像：docker image prune

通过Docker Run更新

• 更新镜像：docker pull docker.xuanyuan.run/linuxserver/nntp2nntp:latest
• 停止运行中的容器：docker stop nntp2nntp
• 删除容器：docker rm nntp2nntp
• 使用相同参数重新创建容器（若正确映射到主机文件夹，/config文件夹和设置将被保留）
• 移除旧镜像：docker image prune

通过Watchtower自动更新（仅在忘记原始参数时使用）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/containrrr/watchtower \
  --run-once nntp2nntp

注意： 我们不推荐使用Watchtower作为现有Docker容器的自动更新解决方案。长期来看，建议使用https://docs.linuxserver.io/general/docker-compose。

镜像更新通知 - Diun

我们推荐使用https://crazymax.dev/diun/获取更新通知。不建议或支持使用其他自动更新容器的工具。

本地构建

如需为开发目的或自定义逻辑对镜像进行本地修改：

bash
git clone https://github.com/linuxserver/docker-nntp2nntp.git
cd docker-nntp2nntp
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/nntp2nntp:latest .

可使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

注册后，可使用-f Dockerfile.aarch64指定要使用的dockerfile。

版本历史

• 04.07.23： - 弃用armhf架构。如https://www.linuxserver.io/blog/a-farewell-to-arm-hf宣布
• 10.10.22： - 基于Alpine 3.15重建
• 19.12.19： - 基于Alpine 3.11重建
• 28.06.19： - 基于Alpine 3.10重建
• 23.04.19： - 多架构构建并从Github fork构建
• 15.05.18： - 初始发布