Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
server:web [2023/12/20 23:03] – Add screen shots from SCFG and SBBSCTRL, rename/order sections digital manserver:web [2023/12/23 02:14] (current) – [Configure] Update SCFG screenshot digital man
Line 15: Line 15:
 ===== Configure ===== ===== Configure =====
  
-The Synchronet Web Server can be configured via [[util:SCFG]]->Servers->Web Server:+The Synchronet Web Server can be configured via [[util:SCFG]]:Servers->Web Server:
  
 <file> <file>
-══════════════════════════════════════════════════════════════════════╗ +╔══════════════════════════════════════════════════════════════════╗ 
-║                              Web Server                              ║ +║                            Web Server                            ║ 
-══════════════════════════════════════════════════════════════════════╣ +╠══════════════════════════════════════════════════════════════════╣ 
-║ │Enabled                       Yes                                   ║ +║ │Enabled                       Yes                               ║ 
-║ │Log Level                     Informational                         ║ +║ │Log Level                     Informational                     ║ 
-║ │HTTP Interfaces               0.0.0.0, ::                           ║ +║ │HTTP Interfaces               0.0.0.0, ::                       ║ 
-║ │HTTP Port                     80                                    ║ +║ │HTTP Port                     80                                ║ 
-║ │HTTPS Support                 Yes                                   ║ +║ │HTTPS Support                 Yes                               ║ 
-║ │HTTPS Interfaces              0.0.0.0                               ║ +║ │HTTPS Interfaces              0.0.0.0, ::                       ║ 
-║ │HTTPS Port                    443                                   ║ +║ │HTTPS Port                    443                               ║ 
-║ │SSJS File Extension           .ssjs                                 ║ +║ │SSJS File Extension           .ssjs                             ║ 
-║ │Index Filenames               index.html, index.ssjs, index.php, ind║ +║ │Index Filenames               index.html, index.ssjs, index.xjs ║ 
-║ │Content Root Directory        ../webv4/root                         ║ +║ │Content Root Directory        ../webv4/root                     ║ 
-║ │Error Sub-directory           error                                 ║ +║ │Error Sub-directory           error                             ║ 
-║ │Strict Transport Security     No                                    ║ +║ │Strict Transport Security     No                                ║ 
-║ │Virtual Host Support          Yes                                   ║ +║ │Virtual Host Support          No                                ║ 
-║ │Access Logging                <disabled>                            ║ +║ │Access Logging                <disabled>                        ║ 
-║ │Max Clients                   100                                   ║ +║ │Max Clients                   100                               ║ 
-║ │Max Inactivity                1 minute                              ║ +║ │Max Inactivity                2 minutes                         ║ 
-║ │Filebase Index Script         webfileindex.ssjs                     ║ +║ │Filebase Index Script         webfileindex.ssjs                 ║ 
-║ │Filebase VPath Prefix         /files/                               ║ +║ │Filebase VPath Prefix         /files/                           ║ 
-║ │Filebase VPath for VHosts     Yes                                   ║ +║ │Filebase VPath for VHosts     No                                ║ 
-║ │Authentication Methods        Basic,Digest,TLS-PSK                  ║ +║ │Authentication Methods        Basic,Digest,TLS-PSK              ║ 
-║ │Output Buffer Drain Timeout   10 ms                                 ║ +║ │Output Buffer Drain Timeout   10 ms                             ║ 
-║ │Lookup Client Hostname        No                                    ║ +║ │Lookup Client Hostname        No                                ║ 
-║ │CGI Support                   No                                    ║ +║ │CGI Support                   No                                ║ 
-══════════════════════════════════════════════════════════════════════╝+║ │CGI Directory                 cgi-bin                           ║ 
 +║ │CGI File Extensions           .cgi                              ║ 
 +║ │CGI Default Content-Type      text/plain                        ║ 
 +║ │CGI Max Inactivity            2 minutes                         ║ 
 +║ │JavaScript Settings...                                          ║ 
 +║ │Failed Login Attempts...                                        ║ 
 +╚══════════════════════════════════════════════════════════════════╝ 
 </file> </file>
  
-... or via [[monitor:SBBSCTRL]]->Web->Configure:+... or via [[monitor:SBBSCTRL]]:Web->Configure:
  
 {{:server:sbbsctrl.3.20.web.config.png|}} {{:server:sbbsctrl.3.20.web.config.png|}}
  
-... or via manual edit of the ''[[dir:ctrl]]/[[config:sbbs.ini]]'' file.+... or via manual edit of the ''[Web]'' section of the ''[[dir:ctrl]]/[[config:sbbs.ini]]'' file.
  
 ==== sbbs.ini ==== ==== sbbs.ini ====
Line 68: Line 75:
 | BindRetryCount    | 2               | Default number of network interface/port bind retry attempts | | BindRetryCount    | 2               | Default number of network interface/port bind retry attempts |
 | BindRetryDelay    | 15               | Default number of seconds to wait between bind attempts | | BindRetryDelay    | 15               | Default number of seconds to wait between bind attempts |
-| MaxClients               //unlimited//    | Maximum number of simultaneous connections supported (0 = unlimited) |+| MaxClients               100              | Maximum number of simultaneous connections supported (0 = unlimited) |
 | MaxInactivity            | ''2m''           | Maximum duration of client inactivity before disconnection | | MaxInactivity            | ''2m''           | Maximum duration of client inactivity before disconnection |
 | MaxCgiInactivity         | ''2m''           | Maximum duration of CGI application inactivity | | MaxCgiInactivity         | ''2m''           | Maximum duration of CGI application inactivity |
Line 81: Line 88:
 | Authentication           | ''Basic,Digest,TLS-PSK ''    | Authentication methods supported | | Authentication           | ''Basic,Digest,TLS-PSK ''    | Authentication methods supported |
 | HttpLogFile              | ''[[dir:data]]/logs/http-''  | Path prefix for HTTP access log files | | HttpLogFile              | ''[[dir:data]]/logs/http-''  | Path prefix for HTTP access log files |
-| FileIndexScript          | ""               | Server-side JavaScript to execute to provide HTML/CSS library and directory listings of virtual file paths | +| FileIndexScript          | ""               | Server-side JavaScript to execute to provide HTML/CSS library and directory listings of virtual file paths (e.g. ''webfileindex.ssjs''
-| FileVPathPrefix          | ""               | Virtual path for file base access, suggested value: ''/files/''+| FileVPathPrefix          | ""               | Virtual path for HTTP file base access, suggested value: ''/files/''
-| FileVPathForVHosts       | ''false''        | If you'd like your virtual hosts to have virtual file path access, set this to ''true'' |+| FileVPathForVHosts       | ''false''        | If you'd like your virtual hosts to provide HTTP access to your file bases (using virtual file paths), set this to ''true'' |
 | OutbufDrainTimeout       | ''10''           | Number of milliseconds to wait for output buffer to drain | | OutbufDrainTimeout       | ''10''           | Number of milliseconds to wait for output buffer to drain |
 | TempDirectory            | ''../temp/''     | Override default temporary file directory | | TempDirectory            | ''../temp/''     | Override default temporary file directory |
Line 90: Line 97:
 === Options === === Options ===
  
-Default value: ''NO_HOST_LOOKUP | HTTP_LOGGING''+The ''Options'' key is set to a ''|'' separated list of options to enable.   
 + 
 +Default value: **''NO_HOST_LOOKUP | HTTP_LOGGING | NO_CGI''**
  
-The ''Options'' key is set to a ''|'' separated list of options to enable.  In addition to the [[config:sbbs.ini|standard options]], the web server also supports the following:+In addition to the [[config:sbbs.ini|standard options]], the web server also supports the following:
  
-**''DEBUG_RX''**+== DEBUG_RX ==
  
 Log all received data to the console log, as well as various Log all received data to the console log, as well as various
 extra bits related to receiving data. extra bits related to receiving data.
  
-**''DEBUG_TX''** +== DEBUG_TX ==
  
 Log all transmitted data except the reply body itself, as well Log all transmitted data except the reply body itself, as well
Line 105: Line 114:
 data. data.
  
-**''DEBUG_SSJS''** +== DEBUG_SSJS ==
  
 Log server-side JavaScript execution details. Log server-side JavaScript execution details.
  
-**''VIRTUAL_HOSTS''**+== VIRTUAL_HOSTS ==
  
 Supports name-based virtual hosts.  If your system has multiple Supports name-based virtual hosts.  If your system has multiple
Line 142: Line 151:
 </code> </code>
  
-**''NO_CGI''**+== NO_CGI ==
  
-Disable CGI script execution.+Disable CGI/FastCGI script execution.
  
-**''HTTP_LOGGING''**+== HTTP_LOGGING ==
  
 Enable logging to a Common Logfile Format log as described in Enable logging to a Common Logfile Format log as described in
Line 152: Line 161:
 programs (like Webalizer: http://www.mrunix.net/webalizer/) programs (like Webalizer: http://www.mrunix.net/webalizer/)
  
-**''NO_JAVASCRIPT''**+== NO_JAVASCRIPT ==
  
 Disable SSJS execution. Disable SSJS execution.
  
-**''ALLOW_TLS''**+== ALLOW_TLS ==
  
-Enable TLS support.+Enable TLS/SSL support.
  
-**''HSTS_SAFE''**+== HSTS_SAFE ==
  
 Indicates that all URLs available via http are also available via https and redirects clients who want a TLS session to the https location. Indicates that all URLs available via http are also available via https and redirects clients who want a TLS session to the https location.