會議在手，主權我有Own your meetings, own your data会議も、データも自分の手に

為什麼需要 jt-vc-portal？Why jt-vc-portal?なぜ jt-vc-portal なのか？

把會議邀請連結到處轉貼、沒有權限與記錄，難以管理也難以稽核。Meeting links passed around everywhere, with no permissions and no records, are hard to manage and impossible to audit.会議リンクがあちこちに転送され、権限も記録もない状態では、管理も監査もできません。

怎麼選？8x8 JaaS 與自建 Jitsi MeetWhich one? 8x8 JaaS vs. self-hosted Jitsi Meetどちらを選ぶ？ 8x8 JaaS とセルフホスト Jitsi Meet

兩種模式都能在管理介面一鍵切換、不必改程式，依團隊規模與維運能力選擇即可。Both modes can be switched with one click in the admin UI without code changes — pick based on your team size and operational capacity.どちらのモードも管理画面からワンクリックで切り替えられ、コード変更は不要です。チームの規模と運用体制に合わせて選んでください。

自建模式：會議需要多少頻寬Self-hosted mode: how much bandwidth a meeting needsセルフホストモード：会議に必要な帯域

2026-10 在自建 Jitsi Meet stable-11031 實際開會量到的數字。每人送出 1280×720、每秒 15 格且一直變化的鏡頭畫面（讓編碼器跑到上限，估線路偏保守）；電腦是 1440×900 瀏覽器視窗、VP9。單位都是 Mbps（每秒百萬位元），跟線路規格（例如 300M / 100M）同一個單位。Measured in October 2026 in real meetings on self-hosted Jitsi Meet stable-11031. Everyone sends 1280×720 camera video at 15 fps that changes constantly (so the encoder runs at its limit — conservative for sizing lines); computers are 1440×900 browser windows using VP9. All figures are in Mbps (megabits per second) — the same unit as line plans (e.g. 300M / 100M).2026 年 10 月にセルフホスト Jitsi Meet stable-11031 で実際に会議を開いて測った数値です。全員が 1280×720・毎秒 15 フレームで常に変化するカメラ映像を送信（エンコーダーを上限まで使わせるため、回線の見積もりとしては控えめな値）、PC は 1440×900 のブラウザーウィンドウで VP9。単位はすべて Mbps（1 秒あたりのメガビット）で、回線プラン（例：300M / 100M）と同じ単位です。

每台電腦需要的頻寬Bandwidth each computer needsPC 1 台に必要な帯域

上傳：被別人放大看（演講者畫面）的人要送 720p，誰都可能被放大，所以每台電腦都以約 1.3 Mbps 規劃（只用並排、預設畫質時約 0.4）。「較高 / 高」是會議室自訂的「小畫面的接收畫質」，電腦並排兩者都收 720p。2 人會議走點對點直連，不經伺服器。Upload: whoever others view large (speaker view) sends 720p, and anyone can be that person, so plan about 1.3 Mbps for every computer (about 0.4 with tile view only at default quality). "Higher / High" is the "receive quality for small tiles" option in meeting room customization; on a computer both receive 720p in tile view. 2-person meetings connect peer-to-peer without the server.アップロード：ほかの人に大きく表示される人（スピーカー表示）は 720p を送り、誰でもそうなり得るため、PC はすべて約 1.3 Mbps で見積もります（タイル表示のみ・既定の画質なら約 0.4）。「高め / 高」は会議室のカスタマイズの「小さい画面の受信画質」で、PC のタイル表示ではどちらも 720p を受信します。2 人の会議はサーバーを通らず P2P で直接接続します。

Jitsi 伺服器需要的頻寬Bandwidth the Jitsi server needsJitsi サーバーに必要な帯域

伺服器收到的是所有人上傳的總和、送出的是所有人下載的總和；人一多，伺服器「上傳」增加最快，申請線路時要特別看上傳。※ 6 人且「較高 / 高」時測試用的單一台電腦 CPU 不夠、編碼器降到 540p，部分數字由每路速率推算。The server receives the sum of everyone's uploads and sends the sum of everyone's downloads; as more people join, the server's upload grows fastest, so check upload speed when ordering a line. ※ With 6 people at "Higher / High" the single test computer ran out of CPU and the encoders dropped to 540p, so some figures are calculated from per-stream rates.サーバーが受信するのは全員のアップロードの合計、送信するのは全員のダウンロードの合計です。人数が増えるといちばん速く増えるのはサーバーのアップロードなので、回線申込時は特に確認してください。※ 6 人で「高め / 高」のときはテスト用の 1 台の PC の CPU が足りずエンコーダーが 540p に下がったため、一部の数値は 1 本あたりのレートから計算しています。

手機：小畫面的接收畫質（4 人並排）Phones: receive quality for small tiles (4 people, tile view)スマートフォン：小さい画面の受信画質（4 人のタイル表示）

安全性：遵循 OWASP Top 10:2025 實作Security: built to OWASP Top 10:2025セキュリティ：OWASP Top 10:2025 に準拠して実装

從設計到部署逐項把關。Checked item by item, from design to deployment.設計からデプロイまで、項目ごとにチェック。

系統需求與安裝Requirements & installationシステム要件とインストール

三種安裝方式，資料與設定皆持久化、更新不遺失。Three ways to install; data and settings are persisted and survive updates.3 通りのインストール方法があり、データと設定は永続化されるため更新しても失われません。

方法一：直接安裝（Apache + PHP）Option 1: Direct install (Apache + PHP)方法 1：直接インストール（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

# Get the code and enable .htaccess
git clone https://github.com/jasoncheng7115/jt-vc-portal.git
cd jt-vc-portal
a2enmod rewrite headers
cp dot.htaccess .htaccess

# Persistent data directory (default /var/jaas-data, adjustable in config.php)
sudo mkdir -p /var/jaas-data && sudo chown www-data:www-data /var/jaas-data

# JaaS mode only: put the 8x8 private key in place
sudo mkdir -p keys && sudo cp /path/to/private.key keys/private.key

# コードを取得して .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 打包部署Option 2: Build and run with Docker方法 2：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

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 mode

docker run -d --restart unless-stopped -p 127.0.0.1:58189:58189 \
  -e JTVC_ADMIN_EMAIL="admin@example.com" \
  -e JTVC_ADMIN_PASSWORD="set-a-strong-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

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 載入預建映像Option 3: Load the prebuilt image from a Release方法 3：Release からビルド済みイメージを読み込む

# 不想自己 build，直接下載 Release 打包映像（linux/amd64）
curl -LO https://github.com/jasoncheng7115/jt-vc-portal/releases/download/v1.25.1/jt-vc-portal-1.25.1-docker-amd64.tar.gz
sha256sum -c jt-vc-portal-1.25.1-docker-amd64.tar.gz.sha256   # 驗證完整性
docker load < jt-vc-portal-1.25.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

# Skip building: download the packaged image from the Release (linux/amd64)
curl -LO https://github.com/jasoncheng7115/jt-vc-portal/releases/download/v1.25.1/jt-vc-portal-1.25.1-docker-amd64.tar.gz
sha256sum -c jt-vc-portal-1.25.1-docker-amd64.tar.gz.sha256   # verify integrity
docker load < jt-vc-portal-1.25.1-docker-amd64.tar.gz        # loads as 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 mode only

docker run -d --restart unless-stopped -p 127.0.0.1:58189:58189 \
  -e JTVC_ADMIN_EMAIL="admin@example.com" \
  -e JTVC_ADMIN_PASSWORD="set-a-strong-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

# 自分でビルドしない場合：Release のパッケージ済みイメージを直接ダウンロード（linux/amd64）
curl -LO https://github.com/jasoncheng7115/jt-vc-portal/releases/download/v1.25.1/jt-vc-portal-1.25.1-docker-amd64.tar.gz
sha256sum -c jt-vc-portal-1.25.1-docker-amd64.tar.gz.sha256   # 完全性を検証
docker load < jt-vc-portal-1.25.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（建議）HTTPS via a reverse proxy (recommended)リバースプロキシによる HTTPS 化（推奨）

系統對外為 :58189，正式環境建議前面再以 nginx 或 Apache 反向代理掛上 HTTPS。The app listens on :58189; in production, put nginx or Apache in front as a reverse proxy to provide 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;
    }
}

# nginx example
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;
    }
}

# 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;
    }
}

更新 / 升級Updating / upgrading更新 / アップグレード

所有設定與資料（帳號、會議室、稽核、用量等）都存在 DATA_DIR 或掛載卷，更新不會遺失，JSON 結構會自動相容升級。更新前仍建議先備份資料目錄與 keys/。All settings and data (accounts, rooms, audit log, usage, etc.) live in DATA_DIR or the mounted volumes, so nothing is lost on update, and the JSON structures are upgraded compatibly and automatically. Backing up the data directory and keys/ before updating is still recommended.すべての設定とデータ（アカウント、会議室、監査ログ、利用量など）は 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

# All methods: back up before updating (recommended)
cp -a /opt/jt-vc-portal/data /opt/jt-vc-portal/data.bak-$(date +%Y%m%d)

# Option 1: direct install
git pull
cp dot.htaccess .htaccess          # if .htaccess changed
sudo systemctl reload apache2      # clears opcache

# Option 2: build with Docker yourself
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

# Option 3: download the prebuilt Release image (no build)
curl -LO https://github.com/jasoncheng7115/jt-vc-portal/releases/latest/download/jt-vc-portal-<new-version>-docker-amd64.tar.gz
docker load < jt-vc-portal-<new-version>-docker-amd64.tar.gz
docker stop jt-vc-portal && docker rm jt-vc-portal      # then docker run again with the same options as Option 2

# 共通：更新前にバックアップ（推奨）
cp -a /opt/jt-vc-portal/data /opt/jt-vc-portal/data.bak-$(date +%Y%m%d)

# 方法 1：直接インストール
git pull
cp dot.htaccess .htaccess          # .htaccess が更新された場合
sudo systemctl reload apache2      # opcache をクリア

# 方法 2：Docker で自分でビルド
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

# 方法 3：Release のビルド済みイメージをダウンロード（ビルドなし）
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      # その後、方法 2 と同じオプションで再度 docker run

附錄：進階文件Appendix: advanced guides付録：詳細ガイド

自建 Jitsi Meet、錄影、單一登入（Keycloak）與逐字稿 / 會議摘要的完整部署 SOP。Complete deployment SOPs for self-hosted Jitsi Meet, recording, single sign-on (Keycloak) and transcripts / meeting summaries.セルフホスト Jitsi Meet、録画、シングルサインオン（Keycloak）、文字起こし / 会議要約の完全なデプロイ手順書（SOP）。