ngsurvey/ngsurveyee

ngSurvey Enterprise Edition 是什么

ngSurvey 是一款高级且易用的本地部署调查软件，可运行于 Windows 或 Linux 系统，并支持 Microsoft SQL Server、PostgreSQL、MySQL 或 MariaDB 作为数据库。

本指南将帮助您在几分钟内启动并运行调查。

如需其他问题、反馈或许可详情，请访问 ngSurvey。

查看 发行说明和变更日志 获取最新更新。

使用方法

要在本地机器上使用端口 8080 运行 ngSurvey：

1. 从 Docker Hub 拉取镜像。
2. 设置必填环境变量 ConnectionStrings:NgSurveyDB，指定数据库主机和详细信息。

bash
docker pull ngsurvey/ngsurveyee:latest
docker run -d --name ngsurvey -p 8080:80 -e "ConnectionStrings:NGSurveyDB=Server=YourSQLServerHost;Initial Catalog=NGSurvey;User ID=youruserid;Password=yourpassword" ngsurvey/ngsurveyee:latest

运行后，通过 http://localhost:8080 访问 ngSurvey，默认账户如下：

• 用户名：ngsadmin
• 密码：admin

如需在 Azure、AWS、Google Cloud 或 Windows Server 等平台部署，请参考相应供应商的 Docker 文档。

使用 Docker Compose - SQL Express

如需快速 5 分钟搭建包含 ngSurvey 和完整配置的 SQL Express 实例（带持久化数据存储）：

1. 下载预配置的 YAML 文件：ngsurveyee.yml。
2. 运行以下命令：

   bash
   docker-compose -f ngsurveyee.yml up
   

ngSurvey 将通过 http://localhost:8080 访问。

• 此设置将创建两个容器：一个用于 ngSurvey，一个用于 SQL Express。
• 即使容器更新或停止，数据也会持久化存储。
• 重要：部署前请使用文本编辑器更新 ngsurveyee.yml 中的默认密码。

使用 Docker Compose - MySQL

如需快速 5 分钟搭建包含 ngSurvey 和完整配置的 MySQL 实例（带持久化数据存储）：

1. 下载预配置的 YAML 文件：ngsurveyee.mysql.yml。
2. 运行以下命令：

   bash
   docker-compose -f ngsurveyee.mysql.yml up
   

ngSurvey 将通过 http://localhost:8080 访问。

• 此设置将创建两个容器：一个用于 ngSurvey，一个用于 MySQL。
• 即使容器更新或停止，数据也会持久化存储。
• 重要：部署前请使用文本编辑器更新 ngsurveyee.mysql.yml 中的默认密码。

使用 Docker Compose - PostgreSQL

如需快速 5 分钟搭建包含 ngSurvey 和完整配置的 PostgreSQL 实例（带持久化数据存储）：

1. 下载预配置的 YAML 文件：ngsurveyee.postgres.yml。
2. 运行以下命令：

   bash
   docker-compose -f ngsurveyee.postgres.yml up
   

ngSurvey 将通过 http://localhost:8080 访问。

• 此设置将创建两个容器：一个用于 ngSurvey，一个用于 PostgreSQL。
• 即使容器更新或停止，数据也会持久化存储。
• 重要：部署前请使用文本编辑器更新 ngsurveyee.postgres.yml 中的默认密码。

数据库设置

ngSurvey 开箱即可自动配置、创建或更新连接字符串中指定的数据库。在 AWS 上运行时，ngSurvey 将自动获取所有 RDS 连接属性。

邮件服务器/第三方 API 设置

安装完成后，可通过 管理 > 系统 > 设置 页面配置邮件服务器。还可设置第三方 API 集成，如 Google reCAPTCHA。

环境变量

ngSurvey 可通过以下变量配置。注意：在 Azure 上，需将变量名中的 : 替换为 __。

• ConnectionStrings:NGSurveyDB
  连接到托管 ngSurvey 的 MS SQL Server、MariaDB、MySQL 或 PostgreSQL 数据库的连接字符串。
• NGSurvey:StorageEngine
  指定数据库存储引擎："MSSQL"（默认，适用于 SQL Server）或 "MySQL"（适用于 MySQL 8.x）。
• NGSurvey:Secret
  唯一密钥值，至少 30 个字符。
• NGSurvey:AutoDBSetup
  自动升级/安装数据库，默认值为 true。
• NGSurvey:CacheTimeout
  缓存持续时间（分钟）（-1 = 永不过期，0 = 禁用）。集群环境下请设为 0。
• NGSurvey:EnableSwagger
  启用 REST API 文档页面。
• NGSurvey:SwaggerRoutePrefix
  REST API 的前缀，默认值为 api。
• NGSurvey:OpenAPIVersion
  生成的 OpenAPI 版本（2 或 3）。
• KeyVault:Name
  用于存储环境变量的 Azure Key Vault 名称。
• AzureAd:ClientId
  Azure Key Vault 客户端 ID。
• AzureAd:ClientSecret
  Azure Key Vault 客户端密钥。
• RDS_HOSTNAME
  RDS 数据库实例的主机名。
• RDS_PORT
  RDS 数据库的端口。
• RDS_DB_NAME
  RDS 数据库的名称。
• RDS_USERNAME
  访问 RDS 数据库的用户名。
• RDS_PASSWORD
  访问 RDS 数据库的密码。

其他安装选项

ngSurvey 还可部署于 IIS、Linux、Azure 或 AWS Elastic Beanstalk 等平台。详细说明请参考 ngSurvey 安装文档。