Polr 2.0 开源短链接系统安装指南

Polr 2.0 开源短链接系统安装指南

polr :aerial_tramway: A modern, powerful, and robust URL shortener 项目地址: https://gitcode.com/gh_mirrors/po/polr

前言

Polr 是一款开源的短链接服务系统，允许用户创建、管理和跟踪短链接。本文将详细介绍如何安装和配置 Polr 2.0 版本，帮助您快速搭建自己的短链接服务平台。

系统要求

在开始安装前，请确保您的服务器满足以下最低要求：

基础环境

• Web服务器：Apache（推荐）、nginx、IIS 或 lighttpd
• 数据库：MySQL ≥5.5 或 MariaDB（推荐），SQLite（不推荐生产环境使用）
• PHP ≥5.5.9

PHP扩展

• OpenSSL
• PDO
• PDO MySQL 驱动（Debian/Ubuntu 上为 php5-mysql）
• Mbstring
• Tokenizer
• JSON
• cURL

安装步骤

1. 获取源代码

建议在服务器上直接获取最新稳定版的源代码：

sudo su
cd /var/www
git clone https://github.com/cydrobolt/polr.git --depth=1
chmod -R 755 polr

对于不同Linux发行版，还需要设置正确的文件所有者：

• Ubuntu系统：chown -R www-data polr
• Fedora/CentOS系统：chown -R apache polr

如果使用SELinux，还需要执行：

chcon -R -t httpd_sys_rw_content_t polr/storage polr/.env

2. 安装Composer依赖

curl -sS https://getcomposer.org/installer | php
php composer.phar install --no-dev -o

如果遇到PHP版本问题，可以尝试：

rm composer.lock
php composer.phar install --no-dev -o

Web服务器配置

Apache配置示例

创建虚拟主机配置文件（如/etc/apache2/sites-enabled/polr.conf）：

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot "/var/www/polr/public"
    <Directory "/var/www/polr/public">
        Require all granted
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

启用mod_rewrite模块：

a2enmod rewrite
service apache2 restart

Nginx配置示例

安装PHP-FPM后，配置示例如下：

upstream php {
    server unix:/var/run/php-fpm.sock;
    server 127.0.0.1:9000;
}

server {
    listen       *:80;
    root         /var/www/polr/public;
    index        index.php index.html index.htm;
    server_name  yourdomain.com;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include /etc/nginx/fastcgi_params;
        fastcgi_pass    php;
        fastcgi_index   index.php;
        fastcgi_param   SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param   HTTP_HOST       $server_name;
    }
}

数据库准备

MySQL数据库创建

CREATE DATABASE polr_db;
CREATE USER 'polr_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON polr_db.* TO 'polr_user'@'localhost';
FLUSH PRIVILEGES;

系统配置

自动配置方式（推荐）

1. 复制环境配置文件：

cp .env.setup .env

2. 通过浏览器访问 /setup 路径完成配置：

http://yourdomain.com/setup

手动配置方式

1. 复制并编辑环境配置文件：

cp resources/views/env.blade.php .env

2. 手动创建数据库表：

php artisan migrate --force
php artisan geoip:update

3. 手动添加管理员用户到数据库的users表中

常见问题解决

1. 文件权限问题：确保storage目录可写
2. 数据库连接失败：检查.env文件中的数据库配置
3. URL重写不工作：确认mod_rewrite已启用（Apache）或nginx配置正确

安全建议

1. 生产环境建议启用HTTPS
2. 定期备份数据库
3. 限制管理后台的访问IP
4. 保持系统及时更新

通过以上步骤，您应该已经成功安装并配置了Polr 2.0短链接服务系统。安装完成后，您可以通过访问配置的域名来使用系统，默认的管理员账户需要在安装过程中设置或手动添加到数据库。

polr :aerial_tramway: A modern, powerful, and robust URL shortener 项目地址: https://gitcode.com/gh_mirrors/po/polr