xiis快速开始从安装部署到首次启动

xiis 以单一可执行文件交付，安装部署可以概括为解压、检查配置、启动与初始化数据库四步，无需配置外部 Web 服务器。程序启动后包含前台、新旧两个后台、系统管理面板与标签生成器五个入口，首次登录后应立即修改默认凭据。

环境要求

程序支持 Windows、Linux 与 macOS 三类操作系统，运行无外部依赖；数据库三选一，生产环境建议 MySQL 或 PostgreSQL，轻量场景可用 SQLite 零部署；内存占用从约二十兆起步，默认端口为前台访问、加密访问与系统管理三个端口。

安装步骤

1. 从下载中心获取最新版本程序包
2. 解压到任意目录，无需安装
3. 检查配置文件中的端口与数据库连接信息
4. 启动程序，端口被占用时自动查杀占用进程后继续启动
5. 首次使用在管理面板执行数据库初始化，按当前方言自动建表
6. 浏览器访问站点地址，看到首页即安装成功

五个入口与初始凭据

网站前台用于访客访问；旧版后台负责内容、栏目、会员与模板管理；新版后台是重写版本，功能与旧版并行；系统管理面板运行在独立端口，负责服务器级配置与运维；标签生成器提供标签速查与组合生成。安装部署完成后，用初始凭据登录后台与面板，随后立即修改为强密码。

配置文件与热更新

核心配置集中在配置目录下的单一配置文件，按功能分节组织，文件修改后自动热更新，无需重启程序；端口、监听地址与数据库类型属于底层项，修改后程序自动重启生效。管理面板可以对同一份配置文件做可视化维护，两种方式写入的是同一个文件。

配置分节的编排与面板导航一一对应：服务器与面板参数、安全策略、静态资源、加密访问、认证、资源保护、性能、日志、数据库与站点列表各自成节。排查配置问题时按节定位，比在整份文件里搜索更快。

站点级配置与全局配置的关系同样重要：带站点覆盖能力的节可以在站点内单独覆盖，未覆盖项自动回退全局；多站点上线时先确认每一项的来源标签，再决定改哪一层。

目录结构速览

业务资产集中在站点目录内：网页目录存放站点静态资源，模板目录存放前台模板，插件目录按站点组织插件，配置目录存放核心配置文件与管理面板页面，数据、日志与证书目录分别承接运行数据与运维资料。理解这份目录清单之后，备份与迁移的范围就很清晰：配置、网页、模板与数据库四块是核心资产。

常见问题

• 端口被占用：程序自动检测并查杀占用进程，无需手工处理
• 数据库初始化：空库或新表前缀首次运行时执行一次，会按方言建表
• 模板改动不生效：确认模板缓存开关与浏览器缓存
• 配置不生效：确认修改的是配置文件而非界面缓存，底层项需重启生效

首次启动后建议的核对顺序是：前台首页、后台登录、面板保存一次配置、数据库连接状态、标签生成器打开。五项都正常，说明运行环境、权限与数据库连接全部就绪。

安装部署的核对标准很简单：前台能打开、后台能登录、面板能保存配置、数据库连接正常。四项都通过后，站点就可以进入内容与模板的搭建阶段。