You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Current »

所有的配置项请参考ServerConfig对象属性: https://pkg.go.dev/github.com/gogf/gf/v2/net/ghttp#ServerConfig

以下为配置文件模板:

server:
    # 基本配置
    address:             ":80"                        # 本地监听地址。默认":80",多个地址以","号分隔。例如:"192.168.2.3:8000,10.0.3.10:8001"
    httpsAddr:           ":443"                       # TLS/HTTPS配置,同时需要配置证书和密钥。默认关闭。配置格式同上。
    httpsCertPath:       ""                           # TLS/HTTPS证书文件本地路径,建议使用绝对路径。默认关闭
    httpsKeyPath:        ""                           # TLS/HTTPS密钥文件本地路径,建议使用绝对路径。默认关闭
    readTimeout:         "60s"                        # 请求读取超时时间,一般不需要配置。默认为60秒
    writeTimeout:        "0"                          # 数据返回写入超时时间,一般不需要配置。默认不超时(0)
    idleTimeout:         "60s"                        # 仅当Keep-Alive开启时有效,请求闲置时间。默认为60秒
    maxHeaderBytes:      "10240"                      # 请求Header大小限制(Byte)。默认为10KB
    keepAlive:           true                         # 是否开启Keep-Alive功能。默认true
    serverAgent:         "GoFrame HTTP Server"        # 服务端Agent信息。默认为"GoFrame HTTP Server"

    # 接口文档
    openapiPath: "/api.json" # OpenAPI接口文档地址
    swaggerPath: "/swagger"  # 内置SwaggerUI展示地址

    # 静态服务配置
    indexFiles:          ["index.html","index.htm"]   # 自动首页静态文件检索。默认为["index.html", "index.htm"]
    indexFolder:         false                        # 当访问静态文件目录时,是否展示目录下的文件列表。默认关闭,那么请求将返回403
    serverRoot:          "/var/www"                   # 静态文件服务的目录根路径,配置时自动开启静态文件服务。默认关闭
    searchPaths:         ["/home/www","/var/lib/www"] # 提供静态文件服务时额外的文件搜索路径,当根路径找不到时则按照顺序在搜索目录查找。默认关闭
    fileServerEnabled:   false                        # 静态文件服务总开关。默认false

    # Cookie配置
    cookieMaxAge:        "365d"             # Cookie有效期。默认为365天
    cookiePath:          "/"                # Cookie有效路径。默认为"/"表示全站所有路径下有效
    cookieDomain:        ""                 # Cookie有效域名。默认为当前配置Cookie时的域名

	# Sessions配置
    sessionMaxAge:       "24h"              # Session有效期。默认为24小时
    sessionIdName:       "gfsessionid"      # SessionId的键名名称。默认为gfsessionid
    sessionCookieOutput: true               # Session特性开启时,是否将SessionId返回到Cookie中。默认true
    sessionPath:         "/tmp/gsessions"   # Session存储的文件目录路径。默认为当前系统临时目录下的gsessions目录

    # 日志基本配置
	# 此配置类似nginx,主要对请求日志的记录
    logPath:             ""                 # 日志文件存储目录路径,建议使用绝对路径。默认为空,表示关闭
    logStdout:           true               # 日志是否输出到终端。默认为true
    errorStack:          true               # 当Server捕获到异常时是否记录堆栈信息到日志中。默认为true
    errorLogEnabled:     true               # 是否记录异常日志信息到日志中。默认为true
    errorLogPattern:     "error-{Ymd}.log"  # 异常错误日志文件格式。默认为"error-{Ymd}.log"
    accessLogEnabled:    false              # 是否记录访问日志。默认为false
    accessLogPattern:    "access-{Ymd}.log" # 访问日志文件格式。默认为"access-{Ymd}.log"

    # 日志扩展配置(参数日志组件配置)
	# 此配置主要影响server(ghttp模块)日志,如web服务监听端口号、web服务路由,不会对 g.Log 产生影响
    logger:
   		path:                  "/var/log/"           # 日志文件路径。默认为空,表示关闭,仅输出到终端
   		file:                  "{Y-m-d}.log"         # 日志文件格式。默认为"{Y-m-d}.log"
   		prefix:                ""                    # 日志内容输出前缀。默认为空
   		level:                 "all"                 # 日志输出级别
   		timeFormat:            "2006-01-02T15:04:05" # 自定义日志输出的时间格式,使用Golang标准的时间格式配置
		ctxKeys:               []                    # 自定义Context上下文变量名称,自动打印Context的变量到日志中。默认为空
		header:                true                  # 是否打印日志的头信息。默认true
		stdout:                true                  # 日志是否同时输出到终端。默认true
		rotateSize:            0                     # 按照日志文件大小对文件进行滚动切分。默认为0,表示关闭滚动切分特性
		rotateExpire:          0                     # 按照日志文件时间间隔对文件滚动切分。默认为0,表示关闭滚动切分特性
		rotateBackupLimit:     0                     # 按照切分的文件数量清理切分文件,当滚动切分特性开启时有效。默认为0,表示不备份,切分则删除
		rotateBackupExpire:    0                     # 按照切分的文件有效期清理切分文件,当滚动切分特性开启时有效。默认为0,表示不备份,切分则删除
		rotateBackupCompress:  0                     # 滚动切分文件的压缩比(0-9)。默认为0,表示不压缩
		rotateCheckInterval:   "1h"                  # 滚动切分的时间检测间隔,一般不需要设置。默认为1小时
		stdoutColorDisabled:   false                 # 关闭终端的颜色打印。默认开启
		writerColorEnable:     false                 # 日志文件是否带上颜色。默认false,表示不带颜色 

    # PProf配置
    pprofEnabled:        false              # 是否开启PProf性能调试特性。默认为false
    pprofPattern:        ""                 # 开启PProf时有效,表示PProf特性的页面访问路径,对当前Server绑定的所有域名有效。

    # 平滑重启特性
    graceful:                false          # 是否开启平滑重启特性,开启时将会在本地增加10000的本地TCP端口用于进程间通信。默认false             
    gracefulTimeout:         2              # 父进程在平滑重启后多少秒退出,默认2秒。若请求耗时大于该值,可能会导致请求中断
    gracefulShutdownTimeout: 5              # 关闭Server时如果存在正在执行的HTTP请求,Server等待多少秒才执行强行关闭


    # 其他配置
    clientMaxBodySize:   810241024          # 客户端最大Body上传限制大小,影响文件上传大小(Byte)。默认为8*1024*1024=8MB
    formParsingMemory:   1048576            # 解析表单时的缓冲区大小(Byte),一般不需要配置。默认为1024*1024=1MB
    nameToUriType:       0                  # 路由注册中使用对象注册时的路由生成规则。默认为0
    routeOverWrite:      false              # 当遇到重复路由注册时是否强制覆盖。默认为false,重复路由存在时将会在启动时报错退出
    dumpRouterMap:       true               # 是否在Server启动时打印所有的路由列表。默认为true






  • No labels