docs/基本配置
更新于 2026-10阅读约 6 分钟

基本配置

Fast-Https 的所有站点都由一个 JSON 配置文件描述,改完配置后重载服务即可生效。本页说明服务如何启动、配置文件在哪、整体结构是什么。

1 启动与托盘菜单

Windows 平台双击软件目录下的 monitor.exe,Linux 平台在终端执行 ./fast-https,任务栏右下角会出现托盘图标。右键菜单提供四个操作:

菜单项作用
START启动 Web 服务
STOP停止 Web 服务
RELOAD重新加载配置文件,进程不退出
QUIT退出托盘程序

2 默认管理页

服务启动后,浏览器访问 http://localhost:8080/ 可以看到 Fast-Https 的默认启动页面,页面上可下载根证书 root.crt(用法见 配置网站通过 HTTPS 访问)。

3 配置文件位置

平台主配置文件
WindowsD:\fast-https_Windows_x86_64\config\fast-https.json
Linux/usr/local/fast-https/config/fast-https.json

4 配置文件结构

一个最小可用的主配置文件如下:

{
  "log_root": "./logs",
  "pid": "./fast-https.pid",
  "http": {
    "include": "mime.types",
    "server": [
      {
        "listen": 8080,
        "server_name": "localhost",
        "location": [
          {
            "url": "/",
            "type": "local",
            "root": "./httpdoc/www.myweb.com",
            "index": ["index.html", "index.htm"]
          }
        ]
      }
    ]
  }
}

顶层配置项:

配置项说明示例
log_root日志目录./logs
pid进程 PID 文件路径./fast-https.pid
http.include引入 MIME 类型表,或站点子配置目录"mime.types" / ["./config/conf.d"]
http.server站点列表,每个元素是一个虚拟主机见下

server 块的常用配置项:

配置项说明
listen监听端口;需要加密时写成 "443 ssl"
server_name该站点的域名
ssl_certificate证书文件路径,仅 ssl 端口需要
ssl_certificate_key私钥文件路径,仅 ssl 端口需要
location路径匹配规则列表,决定请求如何被处理

location 块靠 type 区分处理方式:

type含义配套配置项参考
local发布本地静态目录root、index、try配置发布本地静态站点
proxy反向代理上游服务proxy_pass、proxy_set_header、proxy_cache反向代理站点配置
rewrite重定向到其他地址rewrite如何为网站配置重定向功能

5 让改动生效

保存配置文件后,点击托盘菜单 RELOAD 重新加载即可。若改动涉及监听端口或证书文件本身,建议先 STOP 再 START,避免端口占用。

JSON 不支持注释,从其他文档复制示例时请把 # 开头的说明行删掉,否则服务读取配置会失败。