Confluence 需要依赖一些 Java 的库才能够允运行。一些依赖的 Java 库应用了 Java 的语言特性，但是又是被 Java 的安全策略所限制的。 这个通常来说是不会造成任何问题的。默认的安全配置策略通常对运行 Confluence 没有任何影响。但是在一些共享服务器或者企业部署环境下，安全设定可能会导致 Confluence 不能正常的工作。 当你尝试运行 Confluence 的时候，你可能会遇到下面的错误： java.security.AccessControlException: access denied (java.lang.RuntimePermission accessDeclaredMembers) at java.security.AccessControlContext.checkPermission(AccessControlContext.java(Compiled Code)) at java.security.AccessController.checkPermission(AccessController.java(Compiled Code)) at java.lang.SecurityManager.checkPermission(SecurityManager.java(Compiled Code)) 运行 Confluence 所需要的权限在下面简单的安全配置文件中。你可能需要将这个信息给你的系统管理员，这样你的系统管理员才可以部署 Confluence 应用。 grant codeBase "file:${catalina.home}/webapps/confluence/-" { permission java.security.AllPermission; }; grant { permission java.lang.RuntimePermission "accessDeclaredMembers"; permission java.lang.reflect.ReflectPermission "suppressAccessChecks"; permission java.lang.RuntimePermission "defineCGLIBClassInJavaPackage"; }; https://www.cwiki.us/display/CONF6ZH/Java+Policy+Settings+for+Enterprise+or+Webhosting+Environments
应用服务器中的最小和最大 JVM Heap 空间配置将会影响系统的性能。Confluence 管理员可能希望对默认的配置进行修改，基于你系统的负载不同配置情况也会有所不同，请参考页面 Server Hardware Requirements Guide 页面中的内容。这个页面只提供了配置所需要的参考并不是为了你的配置提供需要遵守的规则。因此系统管理员可以用这个文档作为开始的内容，希望我们能够为你提供一些指引。 有关 Confluence 在 Sun JRE 中的内存管理的完整参考，或者内存性能的修改提升，请参考页面 Garbage Collector Performance Issues 中的内容。 为内存优化设置进行测试 在基本情况下，JIRA 和 Confluence 用户只需要配置最大和最小的需要的值就可以了。在更大的安装那就行，这个配置也对内存的使用会有帮助。如果你的实例中遇到了内存溢出错（Out of Memory Heap），尝试增加你安装实例中的 -Xmx 和 -Xms 值看问题是否能得到解决或者能够帮助你解决你遇到的问题。最好在每次增加的时候只增加一小部分（例如，每次增加 512MB）来避免 heap 太大，这个也会导致不同的问题。如果你增加了内存对你出现的问题也还是没有什么帮助的话，请想我们提交支持帮助，因为这个又可能是其他问题导致的。 内存的使用最大值最有可能是在 creating a site XML backup 的时候出现。在很多时候站点备份可能会导致 OOM，因此增加 -Xmx 值后进行系统备份，然后在看你对系统备份的时候会不会出现 OOM 的错误。一个针对内存进行成功调整的规则是针对用户的使用感觉。系统变得根据快了吗？系统还是一样的速度吗？在对系统进行备份的时候是否还是一样的问题？ Atlassian 推荐的配置是针对常规使用的，你可以禁用 XML 的备份方式，在你的 Confluence 安装实例中使用 Production Backup Strategy 进行备份。 如果你通常使用的是手动的 XML 站点备份方式，你可以针对你安装的 Confluence 实例进行手动备份，通常在这种情况下 Confluence 是运行在最高内存消耗和最大系统负载的情况下的。 如果你没有创建手动的 XML 备份，你可以在系统最高负载的情况下对系统进行监控。 应用内存设置 请参考 How to fix out of memory errors by increasing available memory。 相关主题 Garbage Collector Performance Issues How to fix out of memory errors by increasing available memory Server Hardware Requirements Guide Performance Tuning Troubleshooting Slow Performance Using Page Request Profiling Tomcat JVM options and Modify the Default JVM Settings https://www.cwiki.us/display/CONF6ZH/Managing+Application+Server+Memory+Settings
数据库 所有的其他数据库，包括有页面，内容都存储在数据库中。如果你安装的 Confluence 是用于评估或者你选择使用的是 Embedded H2 Database 数据库。数据库有关的文件将会存储在 database/ 目录中，这个目录位于 Home 目录下面。否则数据库将会存储你 Confluence 站点所使用的所有数据。 临时目录（安装目录） temp 目录是由 Java 运行时进行配置的，同时一些 Confluence 的组件将会写入历史文件或者锁定文件到这个目录中。 临时目录位于安装目录下的 /temp 目录中。 希望修改这个目录的位置，重启你的 Java虚拟机（Java Virtual Machine）的时候配置下面的参数： -Djava.io.tmpdir=/path/to/your/own/temp/directory. 请注意：这个临时目录与 Confluence Home 目录中导出的临时目录是不相同的。请查看上面表格中有关 <confluence-home>/temp 的配置来修改你临时目录的配置。 https://www.cwiki.us/display/CONF6ZH/Confluence+Home+and+other+important+directories
当 Confluence 第一次启动的时候，Confluence 将会读取 confluence-init.properties 文件并从这个文件中确定如何去查找 Home 目录。 希望修改 home 目录的路径，你可以在 confluence-init.properties 文件中按照下面的格式修改 confluence.home 的属性： Windows 在 Window 环境下，路径 C:\confluence\data 将会被写成： confluence.home=C:/confluence/data 请注意需要将反斜杠（\）修改为斜杆（/） Linux / Solaris 在任何基于 Linux 环境的系统中，属性的定义遵守 Linux 定义的常规句法： confluence.home=/var/confluence/ 符号链接（symbolic links） 在 Confluence 的 home 目录中，可能会有一些符号链接。你需要必须定义为绝对路径。如果你有磁盘空间存储的问题，请修改 confluence.home 目录的配置指派到有足够空间的磁盘。生成文件所使用的绝对路径（例如导出的时候）将会使用 confluence.home 中配置的绝对路径，当在构造 URLs 的时候。当一个子目录有不同的的路径的时候，URL 的构造可能会不正常，你可能会收到页面没有找到的错误。这个信息用来避免下页面中显示目录的所有结构。 修改 Confluence 配置 Confluence 配置文件：confluence-cfg.xml 在 home 目录中可能参照你 Confluence home 目录的原始位置。你需要编辑这个文件来升级参考这些文件指向到新的位置。在这个文件中有下面 2 个属性可以进行配置： daily.backup.dir 如果你还没有配置，你的备份已经在其他地方进行存储了。 hibernate.connection.url 如果你现在正在使用嵌入的 HSQL 数据库。 https://www.cwiki.us/display/CONF6ZH/Confluence+Home+and+other+important+directories
Confluence Home 目录是存储 Confluence 信息，查找索引，页面附件的地方。其实 Home 目录也可以定义为数据目录。 找到 Home 目录 Confluence 的 home 目录是你在安装 Confluence 的时候定义的。存储位置定义在 confluence-init.properties 文件中，这个文件位于你 Confluence 安装目录的 confluence/WEB-INF/classes 目录下。 当 Confluence 正在运行的时候，你可以从下面的配置连接中找到 home 目录的配置路径： > 基本配置（General Configuration） > 系统信息（System Information） > Confluence 信息 - Home 目录（Confluence Information - Confluence Home）。 如果你现在正在使用的是 Confluence 数据中心（集群服务器），同时你已经配置了共享 home （shared home）目录，这个目录中应该已经有一些数据了（例如附件和备份等），那么你共享目录的大小可能改变。你共享目录的路径应该在你的 <local-home>/confluence.cfg.xml 文件中的 confluence.cluster.home 属性定义。 Home 目录中的内容 Confluence home 目录存储了 Confluence 在运行中所使用的数据。下面对 Confluence home 目录中使用的数据和文件进行一些说明： 文件或目录（File or directory） 用途（Purpose） confluence.cfg.xml 这个文件有 Confluence 能正常启动所需要的所有配置，例如有： 产品许可证（Product license） 上下文路径（Context path） 数据库配置细节，例如数据库地址，连接池配置等 重要目录的路径 attachments/ 这个目录存储了 Confluence 所使用附件的每一版本。 你可以为你的附件存储指定一个特定的其他目录，这个配置是在 confluence.cfg.xml 文件中的 attachments.dir 配置定义的。 在数据中心模式下，这个目录通常是能在 Shared Home 目录中定义的。 backups/ Confluence 将会把每天的备份文件存储在这里，同时也会存储你手动创建的备份文件。在这个备份目录中的备份文件通常的文件名是按照 daily-backup-YYYY_MM_DD.zip 格式定义的。 你可以为你的备份文件存储指定一个特定的其他目录，这个配置是在 confluence.cfg.xml 文件中的 daily.backup.dir 配置定义的。 在数据中心模式下，这个目录通常是能在 Shared Home 目录中定义的。 bundled-plugins/ Confluence 安装了一系列的插件。bundled-plugins 目录是 Confluence 在启动的时候解压压缩的插件后存储的地方。这个目录将会在 Confluence 每一次重启的时候进行刷新，所以将这个目录中安装的插件删除的话是不会删除 Confluence 已经安装的插件的。因为这些内容将会在下一次 Confluence 重启的时候重新创建。 database/ 这个是 Confluence 运行使用 Embedded H2 Database 模式的时候数据库存储的位置。在这种情况下，这个目录存储了 Confluence 运行所需要的所有数据库数据。如果你配置 Confluence 使用外部数据库例如你使用的数据库是 MySQL 的话，这个目录是不需要的。 index/ Confluence 的索引在 Confluence 使用的频率非常高，查找 Confluence 最近更新的内容列表对 Confluence 运行来说是非常重要的。如果这个目录中的数据丢失或者损坏了，你可以通过重构完整索引的方式将这些内容进行恢复。这个过程可能要花费很差的时间，花费时间的长度与你系统运行的数据量有多少有关系。 你可以为你的索引文件存储指定一个特定的其他目录，这个配置是在 confluence.cfg.xml 文件中的 lucene.index.dir 配置定义的。 journal/ 所以添加的日志（journal ）存储在这里，这个添加的日志为你对页面进行修改的的时候（例如，页面添加了评论，点赞，新页面等）。Journal 中的内容将会被处理并添加到索引中（每 5 秒钟处理一次）。 在集群环境下，这个目录中保存了各个实例需要同步的内容。keeps the indexes on each node in sync. logs/ Confluence 的应用程序日志存储在这个目录中。 plugin-cache/ 所有的 Confluence 插件存储在数据库中。为了能够更加快速的访问插件所需要的 Jar 文件，Confluence 将会把这些存储在数据库中的插件缓存到本地上来，这个缓存目录为 plugin-cache 目录。这个目录中的内容将会在 Confluence 每一次重新启动的时候刷新，在每一次 Confluence 重新启动的时候，数据将会从 Confluence 数据库中缓存到这里，将这个目录中安装的插件删除的话是不会删除 Confluence 已经安装的插件的。 temp/ temp 目录被用来使用为运行时候的功能临时存储的地方，例如导出，导入，文件上传和索引。在这个目录中存储的文件为临时存储的文件。当 Confluence 实例没有运行的时候，你可以安全的清空这个文件夹中的所有内容。一个每天运行的计划任务将会删除这个文件中不在需要的文件。 你可以为你的备份文件存储指定一个特定的其他目录，这个配置是在 confluence.cfg.xml 文件中在 webwork.multipart.saveDir 配置新的存储位置。 thumbnails/ 为图片缩略图存储的临时文件目录。这个目录只用来使用为缩略图的换成，当这个文件中的内容删除后，当图片下一次访问的时候，系统会重新将文件的缩略图存在这个文件夹中创建。 在数据中心模式下，这个目录通常是能在 Shared Home 目录中定义的。 https://www.cwiki.us/display/CONF6ZH/Confluence+Home+and+other+important+directories
Confluence 安装目录 Confluence 安装的目录（Confluence Installation directory）定义的是 Confluence 是在那里进行安装的。这个目录有时候也被称为 Confluence 安装目录（Confluence Install directory）。 安装目录中的一些重要文件： bin/setenv.bat or bin/setenv.sh 这个文件通常被用来编辑 CATALINA_OPTS 内存和垃圾回收的设置，同时也定义了系统的属性。 confluence/WEB-INF/classes/confluence-init.properties 这个文件中定义了 Confluence Home 目录的位置。 https://www.cwiki.us/display/CONF6ZH/Confluence+Home+and+other+important+directories
本部分对你 Confluence 的外部设置进行描述。包括有如何配置 Web 服务器，应用服务器，目录和文件等信息—— Confluence 运行所需要的所有环境。有关在服务器内部对配置进行修改的内容请参考页面Configuring a Confluence Environment 中的内容。 Confluence 是一个 J2EE web 应用。在客户端层面，用户主要通过浏览器来访问 Confluence。 这个部分包含有下面的一些导引： Confluence Home and other important directories Application Server Configuration Starting Confluence Automatically on System Startup 图片：一个 Confluence 安装 https://www.cwiki.us/display/CONF6ZH/Configuring+a+Confluence+Environment
添加 SSL 如果你计划在你的应用中启用 SSL ，请参考 Securing your Atlassian applications with Apache using SSL 页面中的内容，并确定你在相同的连接器中选择 HTTPS。 更多信息 mod_proxy_html 站点提供了一些示例来为你如何配置反向代理提供帮助。 Apache Week has a tutorial 这个指南提供了如何解决复杂的配置情况和 ProxyHTMLURLMap。 https://www.cwiki.us/display/CONF6ZH/Using+Apache+with+mod_proxy
在这些示例中，我们使用下面的信息： 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 文件中，使用示例的连接器为你的起始点。 注释掉默认的连接器（针对不使用代理的访问）。 显示如何进行配置.. 在 HTTP - Proxying Confluence via Apache or Nginx over HTTP 头部列出的内容，取消注释连接器。 显示如何进行配置.. 在上面显示内容的最下面，插入你的 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：不使用上下文的配置 在这个示例中，如果你已经跳过了第一步的配置，没有使用上下文路径进行访问，例如访问的 URL 为 http://www.example.com/。 在这个示例中，用户将会连接到 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…
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 配置的时候遇到的问题。请意识到，这个页面中的内容只是为配置向你提供相关的的信息，如果参考这个页面配置产生的任何问题，后果自负。 https://www.cwiki.us/display/CONF6ZH/Using+Apache+with+mod_proxy