james9074/polr

Polr URL短缩服务镜像

![Logo]([***] 一个现代、极简且轻量级的URL短缩服务。

快速开始 - API文档 - https://github.com/cydrobolt/polr/blob/master/.github/CONTRIBUTING.md - https://github.com/cydrobolt/polr/issues - IRC频道

![构建状态]([] ![文档]([]

Polr是一款开源、可自托管的链接缩短Web应用，拥有强大的API。它允许你部署自己的URL短缩服务，打造品牌化URL，并完全掌控数据。Polr使用简单，且提供现代、可定制主题的界面。

注意：Polr的容器化开发正在进行中，详情见https://github.com/cydrobolt/polr/pull/339%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8Ehttps://github.com/programster/polr/tree/docker%E6%8F%90%E4%BE%9B%E7%9A%84Polr%E5%88%86%E6%94%AF%E6%9E%84%E5%BB%BA%E3%80%82

快速开始

你可以通过提供的docker-compose文件启动Polr，或单独运行容器并使用自己的MySQL服务器。无论哪种方式，启动容器后在浏览器中访问，会看到配置页面（以下示例值为模板参考）：

!Polr配置

使用docker-compose

Polr目前尚未支持环境变量或密钥配置，因此最佳方式是搭配MySQL实例启动并手动配置。

yaml
version: '2'
services:
  polr:
    image: james9074/polr:latest
    volumes:
    - /data/polr/web:/data
    links:
    - db:db
    ports:
    - 80:80/tcp
  db:
    image: mysql
    environment:
      MYSQL_DATABASE: polr
      MYSQL_PASSWORD: polr-password
      MYSQL_ROOT_PASSWORD: super-secure-pw
      MYSQL_USER: polr
    volumes:
    - /data/polr/db:/var/lib/mysql

不使用docker-compose

注意：Polr仅需要一个运行中的MySQL实例即可工作。上述docker-compose文件已包含MySQL，但如果不使用该文件，你需要自行准备MySQL实例并预先创建数据库。

bash
#!/bin/bash
# 移除现有polr容器
docker kill polr-container
docker rm polr-container

# 部署polr容器到80端口，挂载主机卷到/data/polr
docker run -d \
-p 80:80 \
--name polr-container \
--volume /data/polr:/data \
james9074/polr:latest

常见问题

提交配置信息后立即出现错误，网站无法正常工作
90%的可能是MySQL用户名/密码问题。官方MySQL镜像不允许root用户外部连接，因此请确保Polr配置使用MYSQL_USER和MYSQL_PASSWORD。若连接失败，Polr暂不会提示修正设置，需删除Polr卷并重新开始。