Axure Cloud本地部署（On-Premises）教程：支持Axure RP9和RP11团队协作使用

随着Axure RP9和RP11的广泛使用，越来越多的产品团队面临Axure Cloud服务的局限性，尤其是在团队协作和原型托管方面。为了突破这些限制，本地部署成为了一个高效且低成本的解决方案。本文详细介绍了如何在本地服务器上部署Axure Cloud，支持Axure RP9和RP11的团队协作与原型托管。

近期因为Axure RP9频频出现无法使用Axure Cloud的问题，导致大家都比较担心未来用Axure官方的Cloud服务可能会受到很多局限性。毕竟之前有很多原型文件都放在Axure上，如果要迁移到其他平台上也不是一件容易的事情，所以想知道有没有什么更好的解决方案。

如果自己的动手能力强，公司也有对应的资源的话，那么我是推荐可以考虑一下“本地部署”的方案。

这种方案既能实现Axure Cloud的团队协作，速度比官方的服务器更快（因为Axure Cloud的服务器在境外）。同时也能做到更快、更便捷的账号权限管控，以及原型资源的集中管控，历史版本管理等，对小团队来说非常方便。而且最关键的是这种方案有“白嫖方案”，可以通过一些手段实现破解，毕竟很多公司并不舍得给产品团队花钱订阅原型工具……

最早知道Axure RP9可以独立部署本地版，是我在网络上无意中看到了这一篇博客，然后我按里面的教程操作了一下，结果发现真的可行，而且操作起来也比较简单。

于是我在前两周又去买了一个Windows服务器，然后结合之前的教程实操验证了一遍，发现现在这个方案还是可以用的，而且还可以支持Axure RP11的文件。也就是无论是使用9还是11，都可以上传文件到本地部署的Axure Cloud中，对不少朋友来说这个方案是非常完美的。

所以，我结合自己的实操记录和之前的教程方案，输出了这篇教程。仅作为学习交流使用，如有侵权或其它，可私聊删除。

01 Axure Cloud的官方教程

Axure官方本来就是支持本地部署的，也有提供对应是本地部署教程，只不过是英文版的，如果需要查看原文，可以访问如下地址。

https://docs.axure.com/axure-cloud/business/install-on-premises

Axure Cloud本地部署（On-Premises）教程：支持Axure RP9和RP11团队协作使用

完成了本地部署之后，有一些自定义的配置项，可以通过修改customsettings.json这个文件实现，具体的配置项和修改方式，可以查看这个链接。

https://docs.axure.com/axure-cloud/business/custom-settings-json

以下是customsettings.json详细的配置教程

customsettings.json文件包含许多配置选项，用于您的Axure Cloud for Business On-Premises服务器。如果您将服务器安装在默认位置，您可以在以下位置找到该文件：

C:Program FilesAxureShare9sitecustomsettings.json

如果您使用自动安装程序安装和设置了服务器，那么该文件中所有最重要的信息都已经为您填写好了。

如果您手动安装服务器，您将通过编辑自定义设置来提供必要的json信息。

提示
如果您不熟悉JavaScript对象表示法（JSON），请查看Mozilla Developer Network的JSON指南。

customsettings示例。包含所有可能字段的json文件

{
  "SessionEncryptionKey": "?H2!h=cmK7%BQ_WejM!YyzvTe3R%#Tfs",
  "RootStoragePath": "C:ProgramDataAxureSharedata",
  "DbDialect": "MySql",
  "ConnectionStrings": {
    "ApplicationServices": "Data Source=123.456.789.10;Database=axshare;User Id=axshare_user;password=123456"
  },
  "MaxFileSize": 1000000000,
  "GenerationTimeoutSeconds": 2700,
  "urls": "http://*:80;https://*:443",
  "MatchProtocolMode": "false",
  "Kestrel": {
    "Certificates": {
      "Default": {
        "Path": "C:Program FilesAxureShare9sitemy-pfx-file.pfx",
        "Password": "123456"
      }
    },
    "Endpoints": {
      "Https": {
        "Url": "https://*:443"
      }
    }
  },
  "AxShareHost": "ux.sunsetsolar.com",
  "AxSitesPrototypeDomain": ".ux.sunsetsolar.com",
  "ShowExceptionDetails": "true",
  "EnablePlugins": "true",
  "EnableBetaFeatures": "true",
  "CustomHeaders": {
    "Strict-Transport-Security": "max-age=31536000",
    "Content-Security-Policy": "default-src *; img-src * data:; script-src 'self' 'unsafe-inline'",
    "Referrer-Policy": "strict-origin-when-cross-origin"
  }
}

必填字段

SessionEncryptionKey

取值范围：至少32个随机字符的字符串

默认值：随机生成的值

"SessionEncryptionKey": "?H2!h=cmK7%BQ_WejM!YyzvTe3R%#Tfs"

该值应该设置为某个秘密值（我们建议至少包含32个随机字符的字符串）。该值用于加密客户端用来标识自己的会话信息。

警告
更改会话加密密钥将使所有用户退出系统。

合法的大数据目录（RootStoragePath）

Value: 系统中存放大对象数据的合法目录

Default: "C:ProgramDataAxureSharedata"

"RootStoragePath": "C:ProgramDataAxureSharedata"

该目录将存储最终用户上传到服务器的Axure RP文件。它还将存储服务器从这些上传的文件生成的HTML文件。

警告
文件夹路径中的反斜杠必须转义，如上例所示。

提示
运行web服务的帐户将需要对该目录具有读和写权限。

数据库类型（DbDialect）

Value: "MySql" or "SqlServer", 取决于你的数据库，前者是MySQL数据库，后者为SQLServer数据库。

Default: "MySql"

ApplicationServices

Value: 链接你数据库的字符串

Default: 自动生成的字符串

"ConnectionStrings": {
  "ApplicationServices": "Data Source=123.456.789.10;Database=axshare;User Id=axshare_user;password=123456"
}


将连接字符串存储到数据库的ConnectionStrings对象的ApplicationServices键中。为了帮助构建数据库的连接字符串，我们推荐使用以下资源：
https://www.connectionstrings.com/

提示
我们建议有以下数据库操作命令权限的用户连接到数据库：

MySql: SELECT, INSERT, UPDATE, DELETE
SqlServer: db_datareader, db_datawriter

可选字段（Optional Fields）

customsettings.json 的自定义字段，允许您修改Axure Cloud for Business On-Premises web服务器的行为和设置。添加这些字段以覆盖服务器的默认值。

最大文件尺寸（MaxFileSize）

Value: 可以上传到服务器的最大文件大小（以字节为单位）的数字

Default: 419430400

"MaxFileSize": 1000000000

提示
最大文件大小不适用于团队项目。

生成超时时间（GenerationTimeoutSeconds）

Value: Axure RP生成器允许运行的最大时间（以秒为单位）的数字

Default: 1800 (30 minutes)

"GenerationTimeoutSeconds": 2700

如果您的组织正在处理需要很长时间才能生成的非常大的文件，请增加此值。如果希望同时生成多个大文件，请确保有足够的计算能力（或多个核心）。

访问链接（urls）

Value: 服务器访问的地址和端口，多个链接用分号分隔

Default: "http://*:80;https://*:443"

"urls": "http://*:80;https://*:443"

配置http/https协议模式（MatchProtocolMode）

Value: "true" or "false"

Default: "true"

"MatchProtocolMode": "true"

用于启用web服务器动态运行HTTP或HTTPS协议，以及连接服务器时使用的端口。例如，http://myserver.com:85将通过端口85提供不安全的HTTP服务，而https://myserver.com将通过端口443提供HTTPS服务（如果配置了HTTPS）。

“MatchProtocolMode”必须设置为“true”，如果你没有在下面的Kestrel对象中配置SSL证书，或者通过反向代理。否则，服务器将始终尝试重定向到HTTPS。

提示
如果“MatchProtocolMode”为true，并且在customsettings中定义了“HttpPort”。那么服务器将始终尝试在给定的端口号上使用HTTP。它被配置为与允许代理功能的行为保持向后兼容性（在IIS中使用Axure Cloud for Business On-Premises需要代理）。

提示
如果设置了AxSitesPrototypeDomain并且“MatchProtocolMode”为“true”，则显示的原型url的方案和端口将与用于连接到服务器的方案和端口匹配。

Kestrel

Kestrel对象用于为应用程序配置托管选项。要了解有关配置Kestrel的更多信息，请参阅Microsoft关于Kestrel的文档：

https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-2.2

配置HTTPS (SSL) 链接

您可以通过提供对pfx文件的访问并在Kestrel对象中添加HTTPS端点来强制HTTPS （SSL）连接到您的Axure Cloud for Business On-Premises服务器。

首先，您需要创建一个pfx文件，其中包含服务器SSL证书的信息。准备好之后，将以下内容添加到自定义设置中.json文件:

"MatchProtocolMode": "false",
"Kestrel": {
  "Certificates": {
    "Default": {
      "Path": "C:Program FilesAxureShare9siteyour-pfx-file.pfx",
      "Password": "password for your pfx file"
    }
  },
  "Endpoints": {
    "Https": {
      "Url": "https://*:443"
    }
  }
}

警告
文件路径中的反斜杠必须转义，如上例所示。

提示
我们强烈建议将pfx文件存储在站点目录中。如果将其存储在不同的位置，请确保LocalSystem帐户对该文件具有Read权限。

Axure服务器域名（AxShareHost）

Value: 您的Axure Cloud for Business On-Premises服务器的域名，如果您已经为它分配了一个

Default: None

"AxShareHost": "ux.sunsetsolar.com"

提示
如果设置了域，则最终用户只能使用该域连接到服务器。

Axure站点原型域名地址（AxSitesPrototypeDomain）

Value: AxShareHost 域名前加上 .

Default: None

"AxSitesPrototypeDomain": ".ux.sunsetsolar.com"

如果没有提供此域，则存储在您的Axure Cloud for Business on – premises服务器上的原型将托管在域名目录（AxShareHost域或服务器的IP地址）上。例如，https://ux.sunsetsolar.com/ABC123，其中ABC123是原型的6位数ID。

如果提供了这个域，原型将被托管在它们自己的子域中。例如：https://ABC123.ux.sunsetsolar.com

提示
为了使用AxSitesPrototypeDomain，你必须提供一个AxShareHost域。

提示
为了启用插件，必须提供AxSitesPrototypeDomain。

显示异常信息（ShowExceptionDetails）

Value: "true" or "false"

Default: "false"

"ShowExceptionDetails": "true"

默认情况下，系统将向客户端发送友好的错误消息。出于安全性考虑，通常建议这样做，但为了发送更详细的错误消息以进行故障排除，将其设置为“true”可能会有所帮助。

启用插件（EnablePlugins）

Value: "true" or "false"

Default: "false"

"EnablePlugins": "true"

当设置为“true”时，该字段将启用托管在Axure Cloud for Business on – premises服务器上的Axure RP原型的插件功能。

提示
为了启用插件，您还必须提供AxSitesPrototypeDomain。

自定义标题（CustomHeaders）

Value: 包含HTTP响应头的键值对的对象

Default: None

"CustomHeaders": {
  "Strict-Transport-Security": "max-age=31536000",
  "Content-Security-Policy": "default-src *; img-src * data:; script-src 'self' 'unsafe-inline'",
  "Referrer-Policy": "strict-origin-when-cross-origin"
}

CustomHeaders字段允许管理员为安全和权限策略定义额外的HTTP响应头。这些标头通过控制浏览器如何处理请求和执行安全协议来增强安全性。

任何有效的HTTP响应头都可以添加到CustomHeaders中。这些示例演示了常用的安全头，但管理员可以根据需要自由地包含其他头。