|描述||Handling of trusted proxy addresses (XFF)|
|问题||尚未完成的工作 · 回報錯誤|
The TrustedXFF extension maintains a list of trusted hosts in a file in CDB format. For details, see meta:XFF project.
The file can be generated using the generate.php maintenance script.
Ensure the files are in the correct location:
- You are in the base directory for your wiki
- ./LocalSettings.php is in that directory
- ./trusted-hosts.txt is in that directory
- ./maintenance/ is directly under it, as is a writeable ./cache/ directory
- ./extensions/TrustedXFF/ is one level further
These most likely need to be actual files, not merely symlinks pointing somewhere else, as the code uses __DIR__ and relative paths.
Insert in LocalSettings.php:
Remain in the base directory; run generate.php using:
php extensions/TrustedXFF/generate.php --conf LocalSettings.php
At this point, there should be an output file created at ./cache/trusted-xff.cdb
If this exists, and Special:Version reports the extension as installed, it should be good to go. If you have more than one wiki, be sure to copy the output file to the ./cache/ directory for each of your MediaWiki installations.
- The extension will not whitelist large ranges, such as an /18 (or wider).
The list will compile with warnings and the large range will be ignored. This is an issue for services like CloudFlare that occupy multiple, huge chunks of IPv4 space.
- The extension will not accept IPv6 ranges in trusted-hosts.txt.
There are a few such ranges hard-coded into TrustedXFF.body.php, but adding more addresses requires editing the code directly.
- Useless where
As of 2019, many wikis force HTTPs for all things. Any manipulation with headers on a proxy compromises HTTPs server authentication unless the proxy possesses an SSL certificate authoritative for the wiki in question. It makes the extension far less useful nowadays than it was originally envisaged.
|此扩展被用于一个或多个维基媒体项目上。 这可能意味着扩展稳定且工作良好，足以用在同等高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中寻找此扩展名称以查看安装它的网站。 详细的已安装扩展的完整列表可在wiki的Special:Version页面找到。|