进阶 yourls.org 2026-11-19 17:39:56 · 2 阅读

第29章 YOURLS 的 Apache 服务器配置指南

服务器配置 Apache​ 这是你的 YOURLS 所需的 .htaccess 文件示例。 创建 .htaccess 文件​ 如果由于文件权限问题导致 .htaccess 文件未能自动创建或更新,你需要手动创建一个。别担心,这很简单。 注意YOURLS 不能与其他由 .htaccess 重写规则驱动的应用(如 WordPress)共享根目录。.htaccess 文件应仅包含 YOURLS 指令,不包含其他重写规则。 YOURLS 安装在根目录​ 如果 YOURLS 的根 URL 是 https://yoursite.com/ 或 https://subdomain.yoursite.com/,根目录下的 .htaccess 文件必须如下所示: # BEGIN YOURLS

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^.*$ /yourls-loader.php [L]

# END YOURLS
YOURLS 安装在子目录中​ 如果 YOURLS 的根 URL 是 https://yoursite.com/somedir/,该子目录中的 .htaccess 文件必须如下所示: # BEGIN YOURLS

RewriteEngine On
RewriteBase /somedir/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^.*$ /somedir/yourls-loader.php [L]

# END YOURLS
将 HTTP 流量全部重定向到 HTTPS​ 在 Apache 配置的 RewriteBase / 规则之前,添加 RewriteCond %{HTTPS} off 和 RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]。 (此处提供完整示例) 为 YOURLS 创建独立目录​ 默认情况下,YOURLS 会将其文件安装在它将要运行的目录中。 本节说明如何让 YOURLS 从 http://sho.rt/ 运行,但所有文件安装在独立的目录中(例如 http://sho.rt/yourls/),同时 YOURLS 仍由父目录提供服务,且无需更改你的 URL。 移动文件 只需创建一个目录(例如 yourls_subdir/),并将所有文件移至该目录中。 .htaccess 在现在已空的目录中,创建一个 .htaccess 文件,内容如下(请将 sho.rt 和 yourls_subdir 替换为你的主机名和目录名)。
RewriteEngine on
RewriteCond %{HTTP_HOST} sho.rt$
RewriteCond %{REQUEST_URI} !^/yourls_subdir/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /yourls_subdir/$1
RewriteCond %{HTTP_HOST} sho.rt$
RewriteRule ^(/)?$ yourls_subdir/yourls-loader.php [L]

注意:这不改变 YOURLS 需要在目录中保留自己的 .htaccess 文件这一事实。 额外技巧 下面这行规则可以阻止对所有“点文件”和“点目录”的访问,但 .well-known/ 除外(它在很多场景下会被正常使用): RewriteRule "(^|/)\.(?!well-known\/)" - [F]
其他资源 .htaccess snippets 是 .htaccess 配置的优质参考资源。 H5BP Server Configs 提供了大量关于 .htaccess 文件的深入技巧和建议。 Nginx 你的 YOURLS 的 yourls.conf 文件应该类似下面这样。 不同安装环境的 server 配置可能各不相同,取决于你的具体需求(既然你选择使用 nginx,理应能根据需求自行调整配置)。 Nginx 基础 server 配置 server {

# HTTP over IPv4 & IPv6
listen 80;
listen [::]:80;

# HTTPS over IPv4 & IPv6
# MUST BE EDITED TO REFLECT YOUR CONFIGURATION
listen 443 ssl;
listen [::]:443 ssl;
ssl_certificate example.com.crt;
ssl_certificate_key example.com.key;

# Server names
# MUST BE EDITED TO REFLECT YOUR CONFIGURATION
server_name example.com www.example.com;

# Root directory
# MUST BE EDITED TO REFLECT YOUR CONFIGURATION
root /path/to/yourls/files;

# Rewrites
location / {
try_files $uri $uri/ /yourls-loader.php$is_args$args;
# if YOURLS is installed in a subdirectory, change the path
# to yourls-loader.php accordingly, eg
# try_files $uri $uri/ /subdir/yourls-loader.php$is_args$args;
}

# PHP engine
location ~ \.php$ {
include fastcgi.conf;
# OR
# include fastcgi_params;

fastcgi_index index.php;

# MUST BE EDITED TO REFLECT YOUR CONFIGURATION
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
}

}
注意:按此配置的设计,直接访问 YOURLS 的裸 server_name 域名会返回 403 "forbidden" 错误:裸域名及任何子目录(如 /admin)都不会返回 index 文件,除非你手动指定完整路径(例如:https://your.yourlsdomain.tld/admin/index.php)。(来源) 其他资源 关于 Nginx 全局配置的技巧和建议,可以参考 H5BP Server Configs,或许能满足你的需求或改善整体使用体验。

评论 (0)