amd64/spiped

** 注意 **：这是https://hub.docker.com/_/spiped的`amd64`架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的"https://github.com/docker-library/official-images#architectures-other-than-amd64"和官方镜像FAQ中的"https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what"。

快速参考

-** 维护者 **：
https://github.com/TimWolla/docker-spiped，https://github.com/docker-library/official-images/pull/1714#issuecomment-219556607

-** 获取帮助的途径 **：
https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic

支持的标签及对应的Dockerfile链接

• https://github.com/TimWolla/docker-spiped/blob/f7100845a437d5e72c79d384113cd657ca6f93de/1.6/Dockerfile

• https://github.com/TimWolla/docker-spiped/blob/2a6429d25e5ebccc2a8075cb8ec85d5dd951579e/1.6/alpine/Dockerfile

快速参考（续）

-** 问题提交地址 **：
https://github.com/TimWolla/docker-spiped/issues?q=

-** 支持的架构 **：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
https://hub.docker.com/r/amd64/spiped/、https://hub.docker.com/r/arm32v5/spiped/、https://hub.docker.com/r/arm32v6/spiped/、https://hub.docker.com/r/arm32v7/spiped/、https://hub.docker.com/r/arm64v8/spiped/、https://hub.docker.com/r/i386/spiped/、https://hub.docker.com/r/ppc64le/spiped/、https://hub.docker.com/r/riscv64/spiped/、https://hub.docker.com/r/s390x/spiped/

-** 已发布镜像的详细信息 **：
https://github.com/docker-library/repo-info/blob/master/repos/spiped（https://github.com/docker-library/repo-info/commits/master/repos/spiped）
（镜像元数据、传输大小等）

-** 镜像更新 **：
https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fspiped
https://github.com/docker-library/official-images/blob/master/library/spiped（https://github.com/docker-library/official-images/commits/master/library/spiped）

-** 本描述的来源 **：
https://github.com/docker-library/docs/tree/master/spiped（https://github.com/docker-library/docs/commits/master/spiped）

spiped

什么是spiped？

Spiped（发音为"ess-pipe-dee"）是一个用于在套接字地址之间创建对称加密和认证管道的工具，通过它可以连接到一个地址（例如本地的UNIX套接字），并透明地与另一个地址（例如另一台系统上的UNIX套接字）建立连接。这类似于ssh -L功能，但不使用SSH，且需要预共享对称密钥。

tarsnap.com/spiped.html

如何使用本镜像

本镜像会自动从/spiped/key文件（-k）获取密钥，并在前台运行spiped（-F）。除此之外，它接受spiped本身的所有选项。可以通过不带参数运行镜像来列出可用标志：

console
$ docker run -it --rm amd64/spiped
usage: spiped {-e | -d} -s <source socket> -t <target socket> -k <key file>
    [-DFj] [-f | -g] [-n <max # connections>] [-o <connection timeout>]
    [-p <pidfile>] [-r <rtime> | -R]

例如，运行spiped以在8025端口接收加密连接并将其转发到本地的25端口，命令如下：

console
$ docker run -d -v /path/to/keyfile:/spiped/key:ro -p 8025:8025 --init amd64/spiped -d -s '[0.0.0.0]:8025' -t '[127.0.0.1]:25'

通常，你会将此镜像与另一个链接的容器结合使用。以下示例将在9200端口接收加密连接，并将其转发到名为elasticsearch的容器的9200端口：

console
$ docker run -d -v /path/to/keyfile:/spiped/key:ro -p 9200:9200 --link elasticsearch:elasticsearch --init amd64/spiped -d -s '[0.0.0.0]:9200' -t 'elasticsearch:9200'

如果不需要绑定到特权端口，可以传递--user spiped使spiped以非特权用户身份运行：

console
$ docker run -d -v /path/to/keyfile:/spiped/key:ro --user spiped -p 9200:9200 --link elasticsearch:elasticsearch --init amd64/spiped -d -s '[0.0.0.0]:9200' -t 'elasticsearch:9200'

生成密钥

可以通过运行以下命令在/path/to/keyfile/文件夹中保存名为spiped-keyfile的新密钥文件：

console
$ docker run -it --rm -v /path/to/keyfile:/spiped/key amd64/spiped spiped-generate-key.sh

之后，通过安全方式（例如使用scp）将spiped-keyfile传输到另一台主机。

镜像变体

amd64/spiped镜像有多种变体，每种变体适用于特定场景。

amd64/spiped:<version>

这是默认镜像。如果你不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器使用（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

amd64/spiped:<version>-alpine

此镜像基于流行的https://alpinelinux.org，可在https://hub.docker.com/_/alpine中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用https://musl.libc.org而非https://www.etalabs.net/compare_libcs.html，因此软件可能会因对libc的依赖或假设不同而遇到问题。有关可能出现的问题及使用Alpine基础镜像的优缺点比较，请参见此Hacker News评论线程。

为最小化镜像大小，Alpine基础镜像通常不包含额外的相关工具（如git或bash）。如果以此镜像为基础，可在自己的Dockerfile中添加所需工具（如果你不熟悉如何安装包，请参见https://hub.docker.com/_/alpine/中的示例）。

许可证

查看本镜像中包含的软件的https://github.com/Tarsnap/spiped/blob/master/COPYRIGHT。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（例如基础发行版中的Bash等，以及主软件的任何直接或间接依赖项）。

可能在https://github.com/docker-library/repo-info/tree/master/repos/spiped中找到一些能够自动检测到的额外许可证信息。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用都符合其中包含的所有软件的相关许可证。