常见问题
星火赋能平台常见问题：部署环境、数据库、国产化与许可协议
要点速览
星火赋能平台支持私有化部署，可运行在 Windows、Linux 与 Docker 上，数据库支持 MySQL、PostgreSQL、SQL Server、SQLite 与国产数据库，表结构和种子数据在首次启动时自动生成。后端同时面向 .NET 8 与 .NET 10，平台按 MIT 与 Apache-2.0 双许可分发。
这篇汇总了企业选型、实施部署和二次开发过程中关于星火赋能平台最常被问到的问题，适合技术负责人、实施工程师和运维人员快速查阅。具体操作步骤请看快速入门，运行报错请看故障排查。
部署与环境 #
星火赋能平台支持私有化部署吗？ #
支持，私有化部署是星火赋能平台的标准交付方式。
平台可以部署在企业内网或专有云环境，数据库、账号与业务数据全部留在企业自己手里，不依赖任何外部 SaaS 服务。平台按项目定制交付，部署方案在实施前根据你的环境确定。
支持哪些操作系统和部署方式？ #
支持 Windows、Linux 与 Docker 部署，并支持部署在二级虚拟目录下。
国产化场景下支持麒麟等国产操作系统和国产中间件。前端管理后台打包后是静态文件，可以由 Nginx 等 Web 服务器托管，并把 /api 反向代理到后端。
支持哪些数据库？需要手工建表吗？ #
支持 MySQL、PostgreSQL、SQL Server、SQLite 以及国产数据库，不需要手工建表。
平台基于 SqlSugar 访问数据库，在后端配置文件 App.json 的 ConnectionStrings 中修改数据库类型与连接串即可。首次启动时平台会自动创建表结构并写入种子数据，之后每次启动还会增量补齐缺失的表和种子记录。
.NET 8 和 .NET 10 应该选哪个？ #
两个都支持，按你的运行环境和团队已有的 SDK 选择即可。
后端工程同时面向 net8.0 与 net10.0 两个目标框架，因此用 dotnet run 启动时必须用 -f net8.0（或 -f net10.0）指定框架，否则会提示“项目面向多个框架”。发布时同样要明确目标框架。
必须安装 Redis 和 Elasticsearch 吗？ #
不是必须的，它们按项目需要启用。
Redis 用于缓存，Elasticsearch 用于集中存储日志（通过 NEST 组件写入）。小规模部署或开发环境可以先不配，访问量和日志量上来后再按交付方案启用。
后端默认会占用哪些端口？ #
本地联调时后端 API 使用 5005，管理后台开发服务使用 8888，后端内置的 MQTT 服务默认使用 1883。
后端监听地址可以通过 ASPNETCORE_URLS 环境变量调整。MQTT 服务默认开启，如果不需要或与其它程序冲突，可以在 Mqtt.json 中修改端口或将其关闭。
安全与合规 #
是否支持国产化与国密算法？ #
支持，平台集成了国密加解密插件，使用 SM2、SM3、SM4 算法进行签名与数据完整性保护。
例如管理后台员工登录时，密码以 SM2 加密后传输。平台在软件层面按等级保护测评要求设计，适用于需要满足等保、密评要求的项目。
默认账号上线前要怎么处理？ #
上线前必须修改所有预置账号的密码，并修改系统配置中的默认密码参数。
平台种子数据会预置超级管理员、系统管理员和若干普通员工测试账号，初始密码见交付清单。用户表的种子数据只补不覆盖，修改后的密码不会被重启还原。同时建议停用不再使用的测试账号、收紧后端跨域配置，并确保管理后台不对公网开放。
平台内置了哪些安全与运维能力？ #
内置 JWT 鉴权、OAuth 2.0 授权登录、验证码、接口限流、操作与访问日志、在线用户与强制下线、服务监控和任务调度。
接口限流基于 AspNetCoreRateLimit，任务调度基于 Sundial，在线用户与公告实时通知基于 SignalR。
开发与升级 #
二次开发应该改哪里？会影响后续升级吗？ #
建议新建自己的应用层工程并引用平台核心层，业务代码写在自己的工程里，这样基本不影响升级。
平台自带的应用层只是示例。接口、服务和控制器采用合并模式，自建应用层可以随主仓库升级。详见代码生成器使用指南。
平台有接口文档吗？ #
有，后端启动后即可访问交互式接口文档。
本地联调地址为 http://localhost:5005/sapi/（Scalar，轻量）和 http://localhost:5005/kapi/index.html（Knife4j 皮肤，功能更全），覆盖管理后台的全部动态 API。
支持移动端吗？ #
支持，源码中包含基于 uni-app 的移动端工程（App/ 目录），可多端发布。
平台还对接了微信小程序开发与微信支付。
多租户和权限怎么配置？ #
在管理后台按“机构 → 职位 → 菜单 → 角色 → 用户”的顺序配置，业务实体继承租户基类即可实现租户隔离。
详细步骤见权限与多租户配置指南。
许可与获取 #
星火赋能平台采用什么许可协议？ #
平台基于 MIT 与 Apache-2.0 双许可分发。
使用前请阅读随源码提供的法律声明与授权条款。
如何获取演示、源码和部署手册？ #
演示与试用请通过联系我们提交业务场景；产品介绍、部署与联调手册、源码与示例工程在资料下载页获取。
在线体验环境与试用账号按需开通，我们会结合你的场景给出落地建议。使用中的技术问题也可以到技术社区交流。