PLANKA

访问

打开浏览器并访问： https://<SERVER_IP>

A browser SSL warning is expected due to the self-signed certificate.

Create an admin user by running the following command on the server:

cd /opt/planka && docker compose run --rm planka npm run db:create-admin-user

Log in using the newly created admin account.

重要文件和目录

• 安装目录： /opt/planka
• Docker Compose 文件： /opt/planka/docker-compose.yml
• App data volume: /var/lib/docker/volumes/planka_data/_data
• PostgreSQL 数据量： /var/lib/docker/volumes/planka_db-data/_data
• Custom terms directory: /opt/planka/terms
• Nginx config: /etc/nginx/sites-available/planka
• Enabled site: /etc/nginx/sites-enabled/planka
• SSL证书： /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem

Common Management Commands

cd /opt/planka

# Check running containers
docker ps

# Logs (live)
docker compose logs -f

# Restart services
docker compose restart

# Stop stack
docker compose down

# Start stack
docker compose up -d

为域名启用SSL

1. 将您的域名指向服务器IP地址。

2. Edit docker-compose.yml to set your domain as BASE_URL: BASE_URL=https://yourdomain.com

3. Restart PLANKA services:

cd /opt/planka/
docker compose up -d

4. 编辑 Nginx 配置文件并替换两处 server_name <IP>; 使用您的域名 (<yourdomain.com>) 同时适用于 HTTP（端口 80）和 HTTPS（端口 443）的封堵：

vim /etc/nginx/sites-available/planka

5. 安装 Certbot：

apt install -y certbot python3-certbot-nginx

6. 运行以下命令生成有效的Let’s Encrypt证书：

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

7. Replace SSL paths in Nginx config:

vim /etc/nginx/sites-available/planka
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

8. 重启 Nginx 以应用更改：

systemctl restart nginx

9. 打开浏览器并访问： https://yourdomain.com