i386/hitch

注意：这是https://hub.docker.com/_/hitch%E7%9A%84%60i386%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22per-architecture%22%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/varnish/docker-hitch

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

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

• https://github.com/varnish/docker-hitch/blob/fa19f55cf3b713e5f6787315c889a3885ab270bf/Dockerfile

快速参考（续）

• 提交issue的位置：
  https://github.com/varnish/docker-hitch/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/hitch/%E3%80%81https://hub.docker.com/r/arm32v7/hitch/%E3%80%81https://hub.docker.com/r/arm64v8/hitch/%E3%80%81https://hub.docker.com/r/i386/hitch/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/hitch (https://github.com/docker-library/repo-info/commits/master/repos/hitch)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fhitch
  https://github.com/docker-library/official-images/blob/master/library/hitch (https://github.com/docker-library/official-images/commits/master/library/hitch)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/hitch (https://github.com/docker-library/docs/commits/master/hitch)

什么是Hitch？

Hitch是由Varnish Software开发的基于libev的高性能SSL/TLS代理。它专为在高规模下终止TLS连接而构建，并将未加密的HTTP流量转发至Varnish或其他HTTP后端。

如何使用此镜像

运行Hitch Docker容器可使用以下命令：

console
$ docker run --name=hitch -p 443:443 i386/hitch

此容器将暴露443端口，这是HTTPS流量所必需的。

配置文件和额外选项

若不带任何参数，容器将运行hitch --config=/etc/hitch/hitch.conf。您可以挂载自己的配置文件以替换默认配置：

console
$ docker run -v /path/to/your/config/file:/etc/hitch/hitch.conf:ro i386/hitch

您还可以通过设置HITCH_CONFIG_FILE环境变量来更改配置文件的路径。

注意，可以在命令行添加额外参数。如果第一个参数以-开头，这些参数将添加到默认命令行；否则将被视为命令。

我们假设您的后端（Varnish或其他）同时支持HTTP/2和PROXY协议。

连接到后端

默认情况下，Hitch将使用https://github.com/varnish/hitch/blob/master/docs/proxy-protocol.md%E8%BF%9E%E6%8E%A5%E5%88%B0%60localhost:8843%60%E7%9A%84%E5%90%8E%E7%AB%AF%E3%80%82%E5%A6%82%E6%9E%9C%E6%82%A8%E7%9A%84%E5%90%8E%E7%AB%AF%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%94%AF%E6%8C%81PROXY%E5%8D%8F%E8%AE%AE%EF%BC%8C%E4%B8%A4%E8%80%85%E5%B0%86%E8%83%BD%E5%A4%9F%E9%80%9A%E4%BF%A1%EF%BC%8C%E4%B8%94%E5%90%8E%E7%AB%AF%E5%B0%86%E8%83%BD%E5%A4%9F%E8%8E%B7%E5%8F%96%E7%9C%9F%E5%AE%9E%E5%AE%A2%E6%88%B7%E7%AB%AFIP%E3%80%82

但您可能在单独的容器中运行后端服务。这种情况下，您需要更改后端设置。您可以通过在挂载的配置文件中修改https://github.com/varnish/hitch/blob/master/hitch.conf.man.rst#backend--%E9%85%8D%E7%BD%AE%E9%A1%B9%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87%E6%B7%BB%E5%8A%A0%E5%91%BD%E4%BB%A4%E8%A1%8C%E9%80%89%E9%A1%B9%E6%9D%A5%E5%AE%9E%E7%8E%B0%E3%80%82

以下是通过命令行选项设置后端的示例，假设后端通过backend.example.com的8443端口可用：

console
$ docker run i386/hitch "--backend=[backend.example.com]:8443"

设置证书

Hitch Docker镜像包含一个自签名证书，存储在/etc/hitch/certs/default。

此证书在Hitch软件包安装过程中自动创建，是使用2048位RSA加密的自签名证书，配置为localhost主机名，有效期为30年。

此证书仅适用于测试。建议通过绑定挂载覆盖证书，使用您自己的证书。

示例如下：

console
$ docker run -v /path/to/your/certificate:/etc/hitch/certs/default:ro i386/hitch

您也可以在挂载的配置文件中覆盖https://github.com/varnish/hitch/blob/master/hitch.conf.man.rst#pem-file--string%E9%85%8D%E7%BD%AE%E9%A1%B9%E3%80%82

如果您希望在命令行指定证书位置，可以将其作为--backend选项的一部分添加。

示例如下：

console
$ docker run i386/hitch "--backend=[backend.example.com]:8443:/path/to/cert.pem"

许可证

查看此镜像中包含的软件的https://github.com/varnish/hitch/blob/master/LICENSE%E3%80%82

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

一些能够自动检测到的额外许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/hitch%E4%B8%AD%E3%80%82

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