访问 Bar Assistant
- 网页界面：
https://<SERVER_IP> - REST API：
https://<SERVER_IP>/bar - Meilisearch：
https://<SERVER_IP>/search - 由于使用了自签名证书，浏览器出现 SSL 警告属于正常现象。
首次设置
1. 在浏览器中打开以下网址： https://<SERVER_IP>
2. 点击注册。
3. 创建第一个用户账户。
4. 注册完成后，通过编辑以下文件禁用公开注册：
vim /root/barassistant/docker-compose.yml
修改 ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
应用更改：
cd /root/barassistant
docker compose up -d
重要文件与目录
- 安装路径：
/root/barassistant - Compose 文件:
/root/barassistant/docker-compose.yml - 环境文件:
/root/barassistant/.env - Nginx 配置：
/etc/nginx/sites-available/barassistant - SSL 证书：
/etc/nginx/ssl/barassistant.crt - SSL 密钥:
/etc/nginx/ssl/barassistant.key - Bar 数据目录：
/var/lib/docker/volumes/barassistant_bar_data/_data - Meilisearch 数据目录：
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
管理 Bar Assistant
查看正在运行的容器：
docker compose -f /root/barassistant/docker-compose.yml ps
重启所有容器：
docker compose -f /root/barassistant/docker-compose.yml restart
跟踪应用日志：
docker compose -f /root/barassistant/docker-compose.yml logs -f
停止应用：
docker compose -f /root/barassistant/docker-compose.yml down
启动应用：
docker compose -f /root/barassistant/docker-compose.yml up -d
管理 Nginx
查看状态：
systemctl status nginx
重启 Nginx：
systemctl restart nginx
重新加载 Nginx：
systemctl reload nginx
验证配置：
nginx -t
为域名启用 SSL
1. 将域名解析到服务器 IP。
2. 编辑 Nginx 配置,把两处 server_name _; 替换为你的域名(server_name <yourdomain.com>)在 HTTP(端口 80)和 HTTPS(端口 443)两个块中都替换:
vim /etc/nginx/sites-available/barassistant
3. 安装 Certbot:
apt install -y certbot python3-certbot-nginx
4. 运行以下命令生成有效的 Let's Encrypt 证书:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. 替换 Nginx 配置中的 SSL 路径:
vim /etc/nginx/sites-available/barassistant
# Before:
# ssl_certificate /etc/nginx/ssl/barassistant.crt;
# ssl_certificate_key /etc/nginx/ssl/barassistant.key;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. 重新加载 Nginx 以应用更改:
systemctl reload nginx
7. 编辑 /root/barassistant/.env 并替换其中的服务器 IP API_URL 和 MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. 重新创建服务:
cd /root/barassistant
docker compose up -d
9. 打开浏览器,访问: https://yourdomain.com
验证反向代理
- 打开
https://yourdomain.com/bar。你应该会看到："This is your Bar Assistant instance." - 打开
https://yourdomain.com/bar/docs。你应该会看到 Swagger API 文档。 - 打开
https://yourdomain.com/bar/api/server/version。你应该会收到包含服务器版本的 JSON 响应，而不是 "Resource not found" 错误。
