bsord/tiles-api

Tiles API

镜像概述和主要用途

Tiles API是https://github.com/bsord/tiles-client应用的后端API服务，主要用于支持前端应用的核心功能，包括创建和保存看板、用户认证以及聊天室管理。该镜像提供了便捷的部署方式，可通过Docker快速启动服务。

核心功能和特性

• 看板管理：支持创建、保存和管理看板数据
• 用户认证：处理用户注册、登录等身份验证功能
• 聊天室管理：提供聊天室创建和消息处理功能
• Websocket支持：通过Websocket实现实时通信
• Docker化部署：支持通过Docker容器快速部署

使用场景和适用范围

适用于需要部署Tiles应用后端服务的场景，需配合https://github.com/bsord/tiles-client前端应用使用。适合个人或团队搭建Tiles协作平台，满足看板管理和实时聊天需求。

使用方法和配置说明

Docker部署

基本运行命令

使用以下命令通过Docker部署Tiles API：

sh
docker run -d --name tiles-api \
  -e MongoURI='mongodb://username:pass@host.io:27017/database' \
  -p 4001:4001 \
  -v "$PWD":/usr/src/app \
  -w /usr/src/app \
  docker.xuanyuan.run/node:8 "npm" "start"

参数说明

• -d：后台运行容器
• --name tiles-api：指定容器名称为tiles-api
• -e MongoURI='mongodb://username:pass@host.io:27017/database'：设置MongoDB连接URI环境变量，需替换为实际的MongoDB连接信息
• -p 4001:4001：端口映射，将容器内4001端口映射到主机4001端口
• -v "$PWD":/usr/src/app：挂载当前目录到容器内/usr/src/app目录
• -w /usr/src/app：设置工作目录为/usr/src/app
• node:8 "npm" "start"：使用node:8镜像，执行npm start命令启动服务

Nginx配置

为同时支持前端和后端服务，可使用以下Nginx配置块：

sh
server {
    listen               443  ssl;
    ssl                  on;
    ssl_certificate fullchain.pem;
    ssl_certificate_key privkey.pem;
    server_name    tiles.mysite.io;
    large_client_header_buffers 4 8k;
    
    # 前端请求代理
    location / {
        proxy_pass      http://127.0.0.1:3000/;
        # WebSocket升级配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
    
    # Socket.io请求代理（实时通信）
    location /socket.io/ {
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:4001/socket.io/;
    }
    
    # Tiles API请求代理
    location /tiles {
        proxy_pass      http://127.0.0.1:4001/tiles;
        # WebSocket升级配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

服务访问

服务启动后，Tiles API将在http://localhost:4001接收请求。