library/hitch

Hitch Docker镜像文档

快速参考

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

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

支持的标签及对应Dockerfile链接

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

快速参考（续）

• 提交问题的位置：
  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 hitch

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

配置文件和额外选项

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

console
$ docker run -v /path/to/your/config/file:/etc/hitch/hitch.conf:ro 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%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 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 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 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%E6%89%BE%E5%88%B0%E3%80%82

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