ricariel/tang

tang Docker镜像文档

镜像概述

基于Alpine Linux的多架构tang Docker镜像，支持在多种硬件架构上运行tang服务器，提供简洁高效的密钥管理服务。

支持的架构

核心功能与特性

• 多架构支持，兼容多种硬件平台
• 轻量级Alpine Linux基础，资源占用低
• 灵活的网络配置，支持IPv4和IPv6监听
• 数据持久化方案，确保密钥数据库长期保存
• 非root用户运行，提升安全性

使用方法

基本运行

通过以下命令启动tang服务器，将容器内8080端口映射到主机1234端口：

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

此命令会在1234端口运行tang服务器。建议使用以下选项优化体验：

• --detach：后台运行容器
• --rm：容器退出后自动清理文件系统
• 考虑使用docker compose工作流（参见：[services/tang]）

IPv4与IPv6配置

默认情况下，tang服务器仅监听IPv4。可通过环境变量配置IPv6监听：

• 启用IPv6（同时保留IPv4）：

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

• 仅启用IPv6（禁用IPv4）：

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

持久化数据库

为使tang数据库不受容器生命周期影响，需将宿主机目录绑定挂载到容器内/db路径：

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

容器启动时会放弃root权限，以非特权用户（UID为DOCKER_UID）运行tang。为确保宿主机用户能访问数据库文件，可通过DOCKER_UID环境变量指定用户ID（例如当前用户ID）：

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%E3%80%82