Using Apache with mod_proxy

中文标题【使用 Apache 和 mod_proxy】

Atlassian 应用允许用户使用反向代理，但是 Atlassian 并不会为这个功能的配置提供支持。因此，Atlassian 也不能保证能够为这些配置提供任何支持。

如果你在配置上有任何需求，请参考 Atlassian Answers 中的内容来获取帮助。

这个页面描述了一个使用 Apache HTTP Server 2.4 来方向代理标准的 Tomcat 容器的方法。你也可以在 NGINX 中找到类似的配置方法。

你可能在下面的情况中需要使用这个配置：

你已经有一个存在的 Apache 网站，同时还希望添加 Confluence 到你已经存在的网站中（例如，http://www.example.com/confluence）。
你已经有多个 Java 的应用了，每一个应用都运行在自己的服务器上，并且使用不同的端口在运行，例如，http://example:8090/confluence 和 http://example:8080/jira 同时你希望你的这个 2 个应用都能运行在常用的 HTTP （80）端口（例如，http://www.example.com/confluence 和 http://www.example.com/jira）。每一个应用都能够被独立的启动，管理和编辑。

备注： 这个页面的文档是有关 Apache 的配置而不是 Confluence 的配置。Atlassian 将会为你在 Confluence 中的配置提供支持，但是我们不能保证能够帮你解决所有有关 Apache 配置的时候遇到的问题。请意识到，这个页面中的内容只是为配置向你提供相关的的信息，如果参考这个页面配置产生的任何问题，后果自负。

本页中的内容：

基本配置

在这些示例中，我们使用下面的信息：

http://www.example.com/confluence - 你计划使用的 URL

http://example:8090/ - Confluence 当前安装的主机名和端口

http://example:8091/ - Synchrony 当前安装的主机名和端口，这个服务被用来提供默认的协同编辑服务

/confluence - 这个是有关你 Confluence 计划使用的上下文（在主机名和端口的后面）

/synchrony - Synchrony 使用的上下文路径，这个提供了协同编辑服务

你需要将上面的 URL 替换成你自己的 URL。

1 设置上下文路径

如果你不需要使用上下文来访问 Confluence，例如你希望使用 www.example.com 来访问这个，你可以跳过这部分的内容。

设置你 Tomcat 中 Confluence 上下文的路径（在主机名和端口的后面）。在这个示例中，上下文路径被配置为 /confluence。

编辑 <installation-directory>conf/server.xml，找到"Context" 的定义：

<Context path="" docBase="../confluence" debug="0" reloadable="true">

然后修改为：

<Context path="/confluence" docBase="../confluence" debug="0" reloadable="true">

在这个示例中，我们已经使用了 /confluence 为上下文的路径。请注意，你不能使用 /resources 为你的上下文路径，这是因为这个上下文的路径在 Confluence 中被用来定义资源，如果你使用这个配置的话，将会在 Confluence 中导致问题。

重启 Confluence，然后你可以尝试使用 http://example:8090/confluence 进行访问，并确保你能正确访问。

2 设置 URL 重定向

下一步，设置 URL 重定向。在 <installation-directory>conf/server.xml 文件中，使用示例的连接器为你的起始点。

注释掉默认的连接器（针对不使用代理的访问）。

显示如何进行配置..

在 XML 的注释中是以  结尾的，这个注释能够保证在 XML 配置文件中被注释的内容不会被应用程序读取。

同时  中的内容是默认的连接器，应该看起来如下。

<!--
========================================================
DEFAULT - Direct connector with no proxy, for unproxied HTTP access to Confluence.
========================================================
-->
<!--
<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
   maxThreads="48" minSpareThreads="10"
   enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
   protocol="org.apache.coyote.http11.Http11NioProtocol"/>
-->

在 HTTP - Proxying Confluence via Apache or Nginx over HTTP 头部列出的内容，取消注释连接器。

显示如何进行配置..

取消注释的部分，你只需要删除  包含的连接器注释就可以了。

下面显示的是默认连接器被注释掉，但是 HTTPS 连接器没有被注释。头部同时保留注释。

<!--
========================================================
DEFAULT - Direct connector with no proxy, for unproxied HTTP access to Confluence.
========================================================
-->
<!--
<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
   maxThreads="48" minSpareThreads="10"
   enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
   protocol="org.apache.coyote.http11.Http11NioProtocol"/>
-->
<!--
========================================================
HTTP - Proxying Confluence via Apache or Nginx over HTTP
========================================================
-->
<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
   maxThreads="48" minSpareThreads="10"
   enableLookups="false" acceptCount="10" debug="0"URIEncoding="UTF-8"
   protocol="org.apache.coyote.http11.Http11NioProtocol"
   scheme="http" proxyName="<subdomain>.<domain>.com" proxyPort="80"/>

在上面显示内容的最下面，插入你的 proxyName 和 proxyPort ：

<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
   maxThreads="48" minSpareThreads="10"
   enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
   protocol="org.apache.coyote.http11.Http11NioProtocol"
   scheme="http" proxyName="www.example.com" proxyPort="80"/>

如果你计划启用 HTTPS，使用 HTTPS - Proxying Confluence via Apache or Nginx over HTTPS. 下面的连接器。

3 配置 mod_proxy

使用下面的一个示例来编辑你的 http.conf 文件中有关应用服务器代理的配置。

你需要针对你的 Apache 启用下面的一些模块，如果这些模块还没有在你的 Apache 中启用的话：

mod_proxy
mod_proxy_http
proxy_wstunnel
mod_rewrite

（proxy_wstunnel 和 mod_rewrite 是针对 Confluence 6.0 需要的新的模块）

http.conf 文件的格式和模块的位置路径，针对你使用操作系统的不同可能有所不同。你们推荐 Windows 的用户在这里配置的时候使用绝对路径。

示例 1：配置上下文路径

在这个示例中，如果你已经在上面的第一步中设置了上下文路径，同时你的 Confluence 服务器也可以通过配置的上下文路径进行访问，例如这个 http://www.example.com/confluence。

在这个示例中，用户将会连接到 Synchrony，这个是针对协同编辑所使用的服务，是通过 WebSockets 直连的。

在配置文件中的配置顺序是非常重要的。

Apache HTTP server 2.4

# Put this after the other LoadModule directives
LoadModule proxy_module /usr/lib/apache2/modules/mod_proxy.so
LoadModule proxy_http_module /usr/lib/apache2/modules/mod_proxy_http.so
LoadModule proxy_wstunnel_module /usr/lib/apache2/modules/mod_proxy_wstunnel.so
LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so

# Put this in the main section of your configuration (or virtual host, if using Apache virtual hosts)
ProxyRequests Off
ProxyPreserveHost On

<Proxy *>
    Require all granted
</Proxy>

ProxyPass /synchrony http://<domain>:8091/synchrony
<Location /synchrony>
    Require all granted
    RewriteEngine on
    RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
    RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
    RewriteRule .* ws://<domain>:8091%{REQUEST_URI} [P]
</Location>
 
ProxyPass /confluence http://<domain>:8090/confluence
ProxyPassReverse /confluence http://<domain>:8090/confluence

<Location /confluence>
    Require all granted
</Location>

注意：如果你使用的是 HTTP Server 2.2，但是你的 Confluence 使用的 6.0 及其后续版本，这个配置是不能成功的。如果你计划使用 SSL ，你需要使用 2.4.10 或者后续版本。

示例 2：不使用上下文的配置

Use this example if you skipped step 1, and will access Confluence without a context path like this http://www.example.com.

As in the previous example, users will connect to Synchrony, which is required for collaborative editing, directly via WebSockets.

The order of directives in the config is important.

Apache HTTP server 2.4

# Put this after the other LoadModule directives
LoadModule proxy_module /usr/lib/apache2/modules/mod_proxy.so
LoadModule proxy_http_module /usr/lib/apache2/modules/mod_proxy_http.so
LoadModule proxy_wstunnel_module /usr/lib/apache2/modules/mod_proxy_wstunnel.so
LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so

# Put this in the main section of your configuration (or virtual host, if using Apache virtual hosts)
 
  ProxyRequests Off
  ProxyPreserveHost On
    
  RewriteEngine On
  RewriteCond %{REQUEST_URI} !^/synchrony
  RewriteRule ^/(.*) http://<domain>:8090/$1 [P]

  <Proxy *>
      Require all granted
  </Proxy>

  ProxyPass /synchrony http://<domain>:8091/synchrony

  <Location /synchrony>
      Require all granted
      RewriteEngine on
      RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
      RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
      RewriteRule .* ws://<domain>:8091%{REQUEST_URI} [P]
  </Location>

  ProxyPass / http://<domain>:8090
  ProxyPassReverse / http://<domain>:8090
   
  <Location />
      Require all granted
  </Location>

Note: It's not possible to use Apache HTTP Server 2.2 with Confluence 6.0 or later. If you plan to use SSL, you will need version 2.4.10 or later.

4 重启 Apache

This is needed to pick up on the new configuration. To restart Apache, run the following command:

sudo apachectl graceful

5 禁用 HTTP 压缩

Having compression run on both the proxy and Tomcat can cause problems integrating with other Atlassian applications, such as Jira. Please disable HTTP compression as per our Using Apache with mod_proxy docs.

6 修改 Confluence 基础 URL

The last stage is to set the Base URL to the address you're using within the proxy, for example http://www.example.com/confluence.

添加 SSL

If you plan to enable HTTPS, see Using Apache with mod_proxy, and make sure you choose the HTTPS sample connector.

Space shortcuts

Page tree