padhihomelab/tang

docker_tang

---

镜像概述和主要用途

基于Alpine Linux的多架构tang Docker镜像，提供轻量级网络绑定加密服务。tang是一个用于安全分发加密密钥的服务器工具，常用于加密磁盘（如LUKS加密）的网络解锁场景，支持客户端通过网络获取密钥以解锁加密存储。

核心功能和特性

• 多架构支持：兼容386、amd64、arm/v6、arm/v7、arm64、ppc64le、s390x等多种硬件架构
• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 灵活网络配置：支持IPv4、IPv6单独或同时启用，可按需配置网络协议
• 数据持久化：通过挂载卷实现tang数据库持久化，避免容器重启后数据丢失
• 安全运行：启动时自动放弃root权限，以非特权用户运行tang服务，提升安全性

支持的架构

使用方法

基本运行

启动tang服务器并映射端口（示例映射主机1234端口到容器8080端口）：

bash
docker run -p 1234:8080 -it padhihomelab/tang

后台运行

添加--detach参数后台运行，--rm参数在容器退出后自动清理文件系统：

bash
docker run --detach --rm -p 1234:8080 padhihomelab/tang

IPv4与IPv6配置

默认情况下，tang仅监听IPv4。可通过环境变量配置网络协议：

• 同时启用IPv4和IPv6：

  bash
  docker run -e ENABLE_IPv6=1 -p 1234:8080 padhihomelab/tang
  

• 仅启用IPv6（禁用IPv4）：

  bash
  docker run -e ENABLE_IPv4=0 -e ENABLE_IPv6=1 -p 1234:8080 padhihomelab/tang
  

持久化数据库

为避免容器生命周期结束后数据丢失，可将主机目录绑定挂载到容器/db目录：

bash
docker run -v /path/to/tang/db:/db \
           -p 1234:8080 \
           -it padhihomelab/tang

容器启动时会以非特权用户（UID为DOCKER_UID）运行tang，因此/path/to/tang/db目录下的文件将归属于容器内$DOCKER_UID用户。若需主机用户访问这些文件，可通过DOCKER_UID环境变量指定主机用户UID（如当前用户UID）：

bash
docker run -v /path/to/tang/db:/db \
           -e DOCKER_UID=$(id -u) \
           -p 1234:8080 \
           -it padhihomelab/tang

关于UID/GID配置的更多信息，参见基础镜像文档：https://github.com/padhi-homelab/docker_alpine-base/#do-i-ever-need-to-override-the-uid-gid-etc-why-are-these-variables-exposed

环境变量说明