會議在手，主權我有

為什麼需要 jt-vc-portal？

把會議邀請連結到處轉貼、沒有權限與記錄，難以管理也難以稽核。

怎麼選？8x8 JaaS 與自建 Jitsi Meet

兩種模式都能在管理介面一鍵切換、不必改程式，依團隊規模與維運能力選擇即可。

安全性：遵循 OWASP Top 10:2025 實作

從設計到部署逐項把關。

系統需求與安裝

兩種安裝方式，資料與設定皆持久化、更新不遺失。

方法一：直接安裝（Apache + PHP）

# 取得程式並啟用 .htaccess
git clone https://github.com/jasoncheng7115/jt-vc-portal.git
cd jt-vc-portal
a2enmod rewrite headers
cp dot.htaccess .htaccess

# 持久化資料目錄（預設 /var/jaas-data，可於 config.php 調整）
sudo mkdir -p /var/jaas-data && sudo chown www-data:www-data /var/jaas-data

# JaaS 模式才需要：放入 8x8 私鑰
sudo mkdir -p keys && sudo cp /path/to/private.key keys/private.key

方法二：Docker 打包部署

git clone https://github.com/jasoncheng7115/jt-vc-portal.git
cd jt-vc-portal
docker build --pull -t jt-vc-portal .

mkdir -p /opt/jt-vc-portal/keys /opt/jt-vc-portal/data
chown 33:33 /opt/jt-vc-portal/data
cp /path/to/private.key /opt/jt-vc-portal/keys/private.key   # JaaS 模式

docker run -d --restart unless-stopped -p 127.0.0.1:58189:58189 \
  -e JTVC_ADMIN_EMAIL="admin@example.com" \
  -e JTVC_ADMIN_PASSWORD="請設定強密碼" \
  -e JTVC_TRUSTED_PROXIES="127.0.0.1,172.16.0.0/12" \
  -v /opt/jt-vc-portal/keys/:/var/www/html/keys \
  -v /opt/jt-vc-portal/data/:/var/jaas-data \
  --name jt-vc-portal jt-vc-portal

方法三：從 Release 載入預建映像

# 不想自己 build，直接下載 Release 打包映像（linux/amd64）
curl -LO https://github.com/jasoncheng7115/jt-vc-portal/releases/download/v1.6.1/jt-vc-portal-1.6.1-docker-amd64.tar.gz
sha256sum -c jt-vc-portal-1.6.1-docker-amd64.tar.gz.sha256   # 驗證完整性
docker load < jt-vc-portal-1.6.1-docker-amd64.tar.gz        # 載入為 jt-vc-portal:latest

mkdir -p /opt/jt-vc-portal/keys /opt/jt-vc-portal/data
chown 33:33 /opt/jt-vc-portal/data
cp /path/to/private.key /opt/jt-vc-portal/keys/private.key   # JaaS 模式才需要

docker run -d --restart unless-stopped -p 127.0.0.1:58189:58189 \
  -e JTVC_ADMIN_EMAIL="admin@example.com" \
  -e JTVC_ADMIN_PASSWORD="請設定強密碼" \
  -e JTVC_TRUSTED_PROXIES="127.0.0.1,172.16.0.0/12" \
  -v /opt/jt-vc-portal/keys/:/var/www/html/keys \
  -v /opt/jt-vc-portal/data/:/var/jaas-data \
  --name jt-vc-portal jt-vc-portal:latest

前端反向代理 HTTPS（建議）

系統對外為 :58189，正式環境建議前面再以 nginx 或 Apache 反向代理掛上 HTTPS。

# nginx 範例
server {
    listen 443 ssl;
    server_name your-domain.com;

    # ssl_certificate     /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:58189/;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

更新 / 升級

所有設定與資料（帳號、會議室、稽核、用量等）都存在 DATA_DIR 或掛載卷，更新不會遺失，JSON 結構會自動相容升級。更新前仍建議先備份資料目錄與 keys/。

# 共同：更新前備份（建議）
cp -a /opt/jt-vc-portal/data /opt/jt-vc-portal/data.bak-$(date +%Y%m%d)

# 方法一：直接安裝
git pull
cp dot.htaccess .htaccess          # 若 .htaccess 有更新
sudo systemctl reload apache2      # 清 opcache

# 方法二：Docker 自行 build
git pull
docker build --pull -t jt-vc-portal .
docker stop jt-vc-portal && docker rm jt-vc-portal
docker run -d --restart unless-stopped -p 58189:58189 \
  -v /opt/jt-vc-portal/keys/:/var/www/html/keys \
  -v /opt/jt-vc-portal/data/:/var/jaas-data \
  --name jt-vc-portal jt-vc-portal

# 方法三：下載 Release 預建映像（不自行 build）
curl -LO https://github.com/jasoncheng7115/jt-vc-portal/releases/latest/download/jt-vc-portal-<新版本>-docker-amd64.tar.gz
docker load < jt-vc-portal-<新版本>-docker-amd64.tar.gz
docker stop jt-vc-portal && docker rm jt-vc-portal      # 再以方法二相同參數重新 docker run

附錄：進階文件

自建 Jitsi Meet 與錄影的完整部署 SOP。