fastFDS常用配置文件参数含义

╰半夏微凉° 2022-12-23 11:10 289阅读 0赞

### fastFDS常用配置文件参数含义 ###

*  tracker.conf
 *   *  disabled
     *  bind\_addr
     *  port
     *  connect\_timeout
     *  network\_timeout
     *  base\_path
     *  max\_connections
     *  work\_threads
     *  store\_lookup
     *  store\_group
     *  store\_server
     *  store\_path
     *  reserved\_storage\_space
     *  log\_level
     *  run\_by\_group
     *  run\_by\_user
     *  allow\_hosts
     *  sync\_log\_buff\_interval
     *  check\_active\_interval
 *  storage.conf
 *   *  disabled
     *  group\_name
     *  bind\_addr
     *  client\_bind
     *  port
     *  connect\_timeou
     *  network\_timeout
     *  heart\_beat\_interval
     *  base\_path
     *  max\_connections
     *  since
     *  buff\_size
     *  disk\_rw\_direct
     *  disk\_rw\_separated
     *  disk\_reader\_threads
     *  disk\_writer\_threads
     *  sync\_wait\_mse
     *  sync\_interval
     *  sync\_start\_time
     *  sync\_end\_time
     *  store\_path\_count
     *  store\_path0
     *  tracker\_server
     *  log\_level
     *  allow\_hosts
 *  client.conf
 *   *  connect\_timeout
     *  network\_timeout
     *  base\_path
     *  tracker\_server
     *  log\_level
     *  use\_connection\_poo
     *  connection\_pool\_max\_idle\_time
     *  load\_fdfs\_parameters\_from\_tracker
     *  use\_storage\_id
     *  storage\_ids\_filename
     *  http.tracker\_server\_port

# tracker.conf #

## disabled ##

# is this config file disabled
    # false for enabled
    # true for disabled
    disabled=false
    # 这个配置文件是否不生效, false 为生效(否则不生效) true反之

## bind\_addr ##

# bind an address of this host
    # empty for bind all addresses of this host
    bind_addr=
    # 是否绑定IP,
    # bind_addr= 后面为绑定的IP地址 (常用于服务器有多个IP但只希望一个IP提供服务)。如果不填则表示所有的(一般不填就OK),相信较熟练的SA都常用到类似功能,很多系统和应用都有

## port ##

# the tracker server port
    port=22122
    # 提供服务的端口,不作过多解释了

## connect\_timeout ##

# connect timeout in seconds
    # default value is 30s
    connect_timeout=30
    #连接超时时间，针对socket套接字函数connect

## network\_timeout ##

# network timeout in seconds
    network_timeout=60
    #  tracker server的网络超时，单位为秒。发送或接收数据时，如果在超时时间后还不能发送或接收数据，则本次网络通信失败。

## base\_path ##

# the base path to store data and log files
    base_path=/home/yuqing/fastdfs
    # base_path 目录地址(根目录必须存在,子目录会自动创建)  # 因此需要先创建根目录
    # 附目录说明: 
      tracker server目录及文件结构：
      ${base_path}
        |__data
        |     |__storage_groups.dat：存储分组信息
        |     |__storage_servers.dat：存储服务器列表
        |__logs
              |__trackerd.log：tracker server日志文件

storage_servers.dat中记录storage server相关信息，字段依次为：
    
    1. group_name：所属组名
      2. ip_addr：ip地址
      3. status：状态
      4. sync_src_ip_addr：向该storage server同步已有数据文件的源服务器
      5. sync_until_timestamp：同步已有数据文件的截至时间（UNIX时间戳）
      6. stat.total_upload_count：上传文件次数
      7. stat.success_upload_count：成功上传文件次数
      8. stat.total_set_meta_count：更改meta data次数
      9. stat.success_set_meta_count：成功更改meta data次数
      10. stat.total_delete_count：删除文件次数
      11. stat.success_delete_count：成功删除文件次数
      12. stat.total_download_count：下载文件次数
      13. stat.success_download_count：成功下载文件次数
      14. stat.total_get_meta_count：获取meta data次数
      15. stat.success_get_meta_count：成功获取meta data次数
      16. stat.last_source_update：最近一次源头更新时间（更新操作来自客户端）
      17. stat.last_sync_update：最近一次同步更新时间（更新操作来自其他storage server的同步

## max\_connections ##

# max concurrent connections this server supported
    # max_connections worker threads start when this service startup
    max_connections=256
    # 系统提供服务时的最大连接数。对于V1.x，因一个连接由一个线程服务，也就是工作线程数。
    # 对于V2.x，最大连接数和工作线程数没有任何关系

## work\_threads ##

# work thread count, should <= max_connections
    # default value is 4
    # since V2.00
    # V2.0引入的这个参数，工作线程数，通常设置为CPU数
    work_threads=4

## store\_lookup ##

# the method of selecting group to upload files
    # 0: round robin
    # 1: specify group
    # 2: load balance, select the max free space group to upload file
    store_lookup=2
    # 上传组(卷) 的方式 0:轮询方式 1: 指定组 2: 平衡负载(选择最大剩余空间的组(卷)上传)
    # 这里如果在应用层指定了上传到一个固定组,那么这个参数被绕过

## store\_group ##

# which group to upload file
    # when store_lookup set to 1, must set store_group to the group name
    store_group=group2
    # 当上一个参数设定为1 时 (store_lookup=1，即指定组名时)，必须设置本参数为系统中存在的一个组名。如果选择其他的上传方式，这个参数就没有效了。

## store\_server ##

# which storage server to upload file
    # 0: round robin (default)
    # 1: the first server order by ip address
    # 2: the first server order by priority (the minimal)
    store_server=0
    # 选择哪个storage server 进行上传操作(一个文件被上传后，这个storage server就相当于这个文件的storage server源，会对同组的storage server推送这个文件达到同步效果)
    # 0: 轮询方式 
    # 1: 根据ip 地址进行排序选择第一个服务器（IP地址最小者）
    # 2: 根据优先级进行排序（上传优先级由storage server来设置，参数名为upload_priority

## store\_path ##

# which path(means disk or mount point) of the storage server to upload file
    # 0: round robin
    # 2: load balance, select the max free space path to upload file
    store_path=0
    # 选择storage server 中的哪个目录进行上传。storage server可以有多个存放文件的base path（可以理解为多个磁盘）。
    # 0: 轮流方式，多个目录依次存放文件
    # 2: 选择剩余空间最大的目录存放文件（注意：剩余磁盘空间是动态的，因此存储到的目录或磁盘可能也是变化的）

## reserved\_storage\_space ##

# reserved storage space for system or other applications.
    # if the free(available) space of any stoarge server in
    # a group <= reserved_storage_space,
    # no file can be uploaded to this group.
    # bytes unit can be one of follows:
    ### G or g for gigabyte(GB)
    ### M or m for megabyte(MB)
    ### K or k for kilobyte(KB)
    ### no unit for byte(B)
    ### XX.XX% as ratio such as reserved_storage_space = 10%
    reserved_storage_space = 10%
    # storage server 上保留的空间，保证系统或其他应用需求空间。可以用绝对值或者百分比（V4开始支持百分比方式）。
    #(指出 如果同组的服务器的硬盘大小一样,以最小的为准,也就是只要同组中有一台服务器达到这个标准了,这个标准就生效,原因就是因为他们进行备份)

## log\_level ##

#standard log level as syslog, case insensitive, value list:
    ### emerg for emergency
    ### alert
    ### crit for critical
    ### error
    ### warn for warning
    ### notice
    ### info
    ### debug
    log_level=info
    # 选择日志级别(日志写在哪?看前面的说明了,有目录介绍哦 呵呵)

## run\_by\_group ##

#unix group name to run this program, 
    #not set (empty) means run by the group of current user
    run_by_group=
    # 操作系统运行FastDFS的用户组 (不填 就是当前用户组,哪个启动进程就是哪个)

## run\_by\_user ##

#unix username to run this program,
    #not set (empty) means run by current user
    run_by_user=
    # 操作系统运行FastDFS的用户 (不填 就是当前用户,哪个启动进程就是哪个)

## allow\_hosts ##

# allow_hosts can ocur more than once, host can be hostname or ip address,
    # "*" means match all ip addresses, can use range like this: 10.0.1.[1-15,20] or
    # host[01-08,20-25].domain.com, for example:
    # allow_hosts=10.0.1.[1-15,20]
    # allow_hosts=host[01-08,20-25].domain.com
    allow_hosts=*
    # 可以连接到此 tracker server 的ip范围（对所有类型的连接都有影响，包括客户端，storage server）

## sync\_log\_buff\_interval ##

# sync log buff to disk every interval seconds
    # default value is 10 seconds
    sync_log_buff_interval = 10
    # 同步或刷新日志信息到硬盘的时间间隔，单位为秒
    # 注意：tracker server 的日志不是时时写硬盘的，而是先写内存。

## check\_active\_interval ##

# check storage server alive interval
    check_active_interval = 120
    # 检测 storage server 存活的时间隔，单位为秒。
    # storage server定期向tracker server 发心跳，如果tracker server在一个check_active_interval内还没有收到storage server的一次心跳，那边将认为该storage server已经下线。所以本参数值必须大于storage server配置的心跳时间间隔。通常配置为storage server心跳时间间隔的2倍或3倍。

# storage.conf #

## disabled ##

# is this config file disabled
    # false for enabled
    # true for disabled
    disabled=false  
    # 这个配置文件是否不生效, false 为生效(否则不生效) true反之

## group\_name ##

# the name of the group this storage server belongs to
    group_name=group1
    # 指定 此 storage server 所在 组(卷)

## bind\_addr ##

## client\_bind ##

# if bind an address of this host when connect to other servers 
    # (this storage server as a client)
    # true for binding the address configed by above parameter: "bind_addr"
    # false for binding any address of this host
    client_bind=true
    # bind_addr通常是针对server的。当指定bind_addr时，本参数才有效。
    # 本storage server作为client连接其他服务器（如tracker server、其他storage server），是否绑定bind_addr。

## port ##

# the storage server port
    port=23000
    #  storage server服务端口

## connect\_timeou ##

# connect timeout in seconds
    # default value is 30s
    connect_timeout=30
    #连接超时时间，针对socket套接字函数connect

## network\_timeout ##

# network timeout in seconds
    network_timeout=60
    #  storage server 网络超时时间，单位为秒。发送或接收数据时，如果在超时时间后还不能发送或接收数据，则本次网络通信失败。

## heart\_beat\_interval ##

# heart beat interval in seconds
    heart_beat_interval=30
    # 心跳间隔时间，单位为秒 (这里是指主动向tracker server 发送心跳)

## base\_path ##

# the base path to store data and log files
    base_path=/home/yuqing/fastdfs
    # base_path 目录地址,根目录必须存在  子目录会自动生成 (注 :这里不是上传的文件存放的地址,之前是的,在某个版本后更改了)

## max\_connections ##

# max concurrent connections server supported
    # max_connections worker threads start when this service startup
    max_connections=256
    # 同上文

## since ##

# work thread count, should <= max_connections
    # default value is 4
    # since V2.00
    # V2.0引入的这个参数，工作线程数，通常设置为CPU数
    work_threads=4

## buff\_size ##

# the buff size to recv / send data
    # default value is 64KB
    # since V2.00
    buff_size = 256KB
    # V2.0引入本参数。设置队列结点的buffer大小。工作队列消耗的内存大小 = buff_size * max_connections
    # 设置得大一些，系统整体性能会有所提升。
    # 消耗的内存请不要超过系统物理内存大小。另外，对于32位系统，请注意使用到的内存不要超过3GB

## disk\_rw\_direct ##

# if read / write file directly
    # if set to true, open file will add the O_DIRECT flag to avoid file caching
    # by the file system. be careful to set this parameter.
    # default value is false
    disk_rw_direct = false
    # V2.09引入本参数。设置为true，表示不使用操作系统的文件内容缓冲特性。
    # 如果文件数量很多，且访问很分散，可以考虑将本参数设置为true

## disk\_rw\_separated ##

# if disk read / write separated
    ##  false for mixed read and write
    ##  true for separated read and write
    # default value is true
    # since V2.00
    disk_rw_separated = true
    # V2.0引入本参数。磁盘IO读写是否分离，缺省是分离的。

## disk\_reader\_threads ##

# disk reader thread count per store base path
    # for mixed read / write, this parameter can be 0
    # default value is 1
    # since V2.00
    disk_reader_threads = 1
    # V2.0引入本参数。针对单个存储路径的读线程数，缺省值为1。
    # 读写分离时，系统中的读线程数 = disk_reader_threads * store_path_count
    # 读写混合时，系统中的读写线程数 = (disk_reader_threads + disk_writer_threads) * store_path_count

## disk\_writer\_threads ##

# disk writer thread count per store base path
    # for mixed read / write, this parameter can be 0
    # default value is 1
    # since V2.00
    disk_writer_threads = 1
    # V2.0引入本参数。针对单个存储路径的写线程数，缺省值为1。
    # 读写分离时，系统中的写线程数 = disk_writer_threads * store_path_count
    # 读写混合时，系统中的读写线程数 = (disk_reader_threads + disk_writer_threads) * store_path_count

## sync\_wait\_mse ##

# when no entry to sync, try read binlog again after X milliseconds
    # 0 for try again immediately (not need to wait)
    sync_wait_msec=200
    # 同步文件时，如果从binlog中没有读到要同步的文件，休眠N毫秒后重新读取。0表示不休眠，立即再次尝试读取。
    # 出于CPU消耗考虑，不建议设置为0。如何希望同步尽可能快一些，可以将本参数设置得小一些，比如设置为10ms

## sync\_interval ##

# after sync a file, usleep milliseconds
    # 0 for sync successively (never call usleep)
    sync_interval=0
    # 同步上一个文件后，再同步下一个文件的时间间隔，单位为毫秒，0表示不休眠，直接同步下一个文件。

## sync\_start\_time ##

# sync start time of a day, time format: Hour:Minute
    # Hour from 0 to 23, Minute from 0 to 59
    sync_start_time=00:00

## sync\_end\_time ##

# sync end time of a day, time format: Hour:Minute
    # Hour from 0 to 23, Minute from 0 to 59
    sync_end_time=23:59
    # 上面二个一起解释。允许系统同步的时间段 (默认是全天) 。一般用于避免高峰同步产生一些问题而设定，相信sa都会明白

## store\_path\_count ##

# path(disk or mount point) count, default value is 1
    store_path_count=1
    # 存放文件时storage server支持多个路径（例如磁盘）。这里配置存放文件的基路径数目，通常只配一个目录。

## store\_path0 ##

# store_path#, based 0, if store_path0 not exists, it's value is base_path
    # the paths must be exist
    store_path0=/home/yuqing/fastdfs
    #store_path1=/home/yuqing/fastdfs2
    # 逐一配置store_path个路径，索引号基于0。注意配置方法后面有0,1,2 ......，需要配置0到store_path - 1。
    # 如果不配置base_path0，那边它就和base_path对应的路径一样。

## tracker\_server ##

# tracker_server can ocur more than once, and tracker_server format is
    #  "host:port", host can be hostname or ip address
    tracker_server=10.62.164.84:22122
    tracker_server=10.62.245.170:22122
    # tracker_server 的列表 要写端口的哦 (再次提醒是主动连接tracker_server )
    # 有多个tracker server时，每个tracker server写一行

## log\_level ##

## allow\_hosts ##

# allow_hosts can ocur more than once, host can be hostname or ip address,
    # "*" means match all ip addresses, can use range like this: 10.0.1.[1-15,20] or
    # host[01-08,20-25].domain.com, for example:
    # allow_hosts=10.0.1.[1-15,20]
    # allow_hosts=host[01-08,20-25].domain.com
    allow_hosts=*
    # 允许连接本storage server的IP地址列表 （不包括自带HTTP服务的所有连接）
    # 可以配置多行，每行都会起作用

# client.conf #

## connect\_timeout ##

# 连接超时时间，针对socket套接字函数connect
    # connect timeout in seconds
    # default value is 30s
    connect_timeout=30

## network\_timeout ##

# client的网络超时，单位为秒。发送或接收数据时，如果在超时时间后还不能发送或接收数据，则本次网络通信失败
    # network timeout in seconds
    # default value is 30s
    network_timeout=60

## base\_path ##

# 存储日志的根目录
    # the base path to store log files
    base_path=/home/yuqing/fastdfs

## tracker\_server ##

# tracker_server 的列表 要写端口
    # tracker_server can ocur more than once, and tracker_server format is
    #  "host:port", host can be hostname or ip address
    tracker_server=192.168.0.197:22122

## log\_level ##

# 日志的级别
    #standard log level as syslog, case insensitive, value list:
    ### emerg for emergency
    ### alert
    ### crit for critical
    ### error
    ### warn for warning
    ### notice
    ### info
    ### debug
    log_level=info

## use\_connection\_poo ##

# 是否使用连接池
    # if use connection pool
    # default value is false
    # since V4.05
    use_connection_pool = false

## connection\_pool\_max\_idle\_time ##

# 如果一个连接的空闲时间超过这个值将会被自动关闭
    # connections whose the idle time exceeds this time will be closed
    # unit: second
    # default value is 3600
    # since V4.05
    connection_pool_max_idle_time = 3600

## load\_fdfs\_parameters\_from\_tracker ##

# 是否从FastDFS的tracker server加载参数
    # if load FastDFS parameters from tracker server
    # since V4.05
    # default value is false
    load_fdfs_parameters_from_tracker=false

## use\_storage\_id ##

是否使用storage ID 代替IP，只有当load_fdfs_parameters_from_tracker为false时才有效
    # if use storage ID instead of IP address
    # same as tracker.conf
    # valid only when load_fdfs_parameters_from_tracker is false
    # default value is false
    # since V4.05
    use_storage_id = false

## storage\_ids\_filename ##

# 指定storage_ids的路径，可以使用绝对路径和相对路径，只有当load_fdfs_parameters_from_tracker为false时才有效
    # specify storage ids filename, can use relative or absolute path
    # same as tracker.conf
    # valid only when load_fdfs_parameters_from_tracker is false
    # since V4.05
    storage_ids_filename = storage_ids.conf

## http.tracker\_server\_port ##

#tracker server的http端口
    #HTTP settings
    http.tracker_server_port=8080
    
    #use "#include" directive to include HTTP other settiongs
    ##include http.conf