diff --git a/docs/manual/bind.xml.zh-cn b/docs/manual/bind.xml.zh-cn new file mode 100644 index 00000000000..81cec9856d1 --- /dev/null +++ b/docs/manual/bind.xml.zh-cn @@ -0,0 +1,190 @@ + + + + + + + + + + + 绑定指定地址与端口 + + +

配置Apache HTTP Server监听特定地址和端口。

+
+ + 虚拟主机 + DNS问题 + +
+ 概览 + + + + core + mpm_common + + + VirtualHost + Listen + + + + +

httpd在启动时会绑定到本地机器的某些端口和地址,以接受入站请求。 + 默认情况下,httpd会监听本地机器的所有地址。不过,有时可能需要对其进行配置, + 指定它监听哪些端口、仅监听哪些特定地址,或者同时指定端口和地址。 + 这通常会与虚拟主机功能结合使用,决定httpd如何响应发往 + 不同IP地址、主机名、端口的请求。

+ +

Listen指令用于指示服务器仅接受发往特定端口或 + 特定地址、端口组合的请求。如果仅在Listen处指定 + 端口,那么服务器将会在所有接口上监听此端口的请求。如果同时指定了IP地址和端口,那么服务器将会监听 + 指定端口和接口。也可以使用多个Listen指令指示服务器 + 监听多个地址和端口,服务器会响应任何来自列在Listen指令中 + 端口和地址的请求。

+ +

例如,如果按下面的配置设置,服务器会接受所有接口中来自80、8000端口的连接:

+ + + +Listen 80 +Listen 8000 + + + +

通过下面的设置,可以让服务器在一个接口上监听80端口,在另一个接口上监听8000端口。

+ + + +Listen 192.0.2.1:80 +Listen 192.0.2.5:8000 + + + +

IPv6地址必须包含在下例所示的方括号内:

+ + + + Listen [2001:db8::a00:20ff:fea7:ccea]:80 + + + +

相互重叠或冲突的Listen指令会产生致命错误,从而导致服务器无法正常启动。

+ + + (48)Address already in use: make_sock: could not bind to address [::]:80 + + +

请查阅wiki上的相关讨论 + 以进一步了解如何排查问题。

+ +
+ +
+ +
+ Changing Listen configuration on restart + +

重启httpd时,需要特别注意与Listen指令相关的更改。 + 重启过程中,httpd会保持原有绑定端口(即原始配置中指示服务器绑定的端口)的绑定状态不变以避免其他客户端在尝试连接 + 服务器时出现“Connection refused”错误。如果修改后的Listen指令与原有配置冲突, + 那么服务器将会停止运行。

+ +

例如下面的配置

+ + + + Listen 127.0.0.1:80 + + + +

修改为下面的配置可能会失败,因为在所有IP地址绑定80端口与仅在127.0.0.1绑定端口相冲突。

+ + + + Listen 80 + + + +

如果想要此类修改生效,就必须先停止服务器,然后再重新启动服务器。

+ +
+ +
+ IPv6特别注意事项 + +

越来越多的平台开始支持IPv6,而APR在大多数平台上也都支持IPv6, + 这使得httpd可以分配IPv6套接字,并能够处理通过IPv6发送的请求。 + + 对于httpd管理员而言,有一个比较复杂的问题,即IPv6套接字是否能够同时处理IPv4和IPv6连接。 + 在大多数平台上,默认情况下可以使用IPv4映射的IPv6地址来在IPv6套接字上处理IPv4连接。为保持与 + FreeBSD、NetBSD、OpenBSD的系统策略一致,在这些平台上默认是禁止使用IPv4映射的IPv6地址的。对于禁止 + 使用IPv4映射的IPv6地址的系统上,可以使用一个特殊的configure参数来改变httpd的行为。

+ +

此外,在某些平台(例如Linux和Tru64)上则是只能使用IPv4映射的IPv6地址来同时处理IPv6和IPv4连接。 + 如果您希望使用尽可能少的套接字来处理IPv4和IPv6连接,请指定--enable-v4-mapped + configure选项以启用IPv4映射的IPv6地址。

+ +

除FreeBSD、NetBSD、OpenBSD外,所有平台都默认启用--enable-v4-mapped。

+ +

如果您希望httpd不考虑平台和APR支持的功能,只处理IPv4连接,请如下例所示,在所有Listen + 指令处指定IPv4地址。

+ + + +Listen 0.0.0.0:80 +Listen 192.0.2.1:80 + + + +

如果您正在使用的平台支持,且您希望httpd通过独立的套接字处理IPv4和IPv6连接(即禁用IPv4映射的IPv6地址), + 请指定configure的--disable-v4-mapped选项。在FreeBSD、NetBSD、OpenBSD上, + --disable-v4-mapped是默认选项。

+
+ +
+ 指定监听的协议 +

Listen指令中可选的第二个参数,大多数情况下不是必须的。 + 如果没有指定,443端口的默认协议是https,其他端口的默认协议则是http。该参数用于 + 确定由哪个模块处理请求,以及适用通过AcceptFilter指令设置的针对特定协议的优化。

+ +

只有在使用非标准端口时,才需要设置协议参数。例如,在8443端口上运行一个https网站。

+ + + + Listen 192.170.2.1:8443 https + + +
+ +
+ 虚拟主机如何工作 + +

Listen指令本身不能实现虚拟主机的功能,它仅用于告知主服务器需要监听哪些地址和端口。 + 如果没有指定VirtualHost指令,那么服务器将以相同方式处理接收到的所有请求。 + 可以使用VirtualHost指令来为一个或多个特定的地址或端口给服务器设置不同的行为。 + 要实现虚拟主机功能,首先需要指示服务器监听所要使用的地址和端口。然后设置VirtualHost + 区块,为该虚拟主机设置相应的地址、端口,以及服务器处理请求时的行为。 + 注意,如果VirtualHost中指示的地址和端口并未被服务器监听,那么客户端无法访问虚拟主机。

+
+