📅 実施日: 2026年4月5日
🎯 目的: WireGuard VPNを持たない外部ユーザーをNextcloud Talkに招待できる機能の実装
✅ 結果: 外部ゲスト招待が完全動作、チャット・ビデオ通話が正常に機能

かつおcloud（みーきゅんクラウド）の顧客が、WireGuard VPNを持たない外部ユーザーをNextcloud Talkに招待し、チャット・ビデオ通話ができる機能を構築しました。

【外部ゲスト（WireGuard不要）】
        ↓
https://talk.katuocloud.com/call/xxxxx
        ↓
Cloudflare Tunnel (6ace0e0b-373d-452f-80be-af40048d0875)
        ↓
R640 nginx port:9082 (talk.katuocloud.com専用vhost)
        ↓
Nextcloud Docker port:9080
        ↓
Nextcloud Talk アプリ

【かつおcloud顧客（WireGuard接続）】
        ↓
https://cloud.k2-o.net/apps/spreed/
        ↓
RTX1300 NAT (port 443)
        ↓
R640 nginx port:443 (cloud.k2-o.net)
        ↓
Nextcloud Docker port:9080
        ↓
Nextcloud Talk アプリ（招待リンク生成）

作業前に手動バックアップを実行しました。

# Nextcloud完全バックアップ
bash /opt/mikyun/bin/nc_backup.sh

# hirame遠隔バックアップ
bash /opt/mikyun/bin/remote_backup.sh

# バックアップ確認
ls -lth /srv/storage/SM-storage/backup/nextcloud/ | head -5

既存のCloudflare Tunnel（portal.katuocloud.com用）に、Talk専用エンドポイントを追加しました。

# /etc/cloudflared/config.yml
tunnel: 6ace0e0b-373d-452f-80be-af40048d0875
credentials-file: /root/.cloudflared/6ace0e0b-373d-452f-80be-af40048d0875.json

ingress:
  - hostname: portal.katuocloud.com
    service: http://127.0.0.1:9000
  
  # 新規: Talk専用エンドポイント
  - hostname: talk.katuocloud.com
    service: http://127.0.0.1:9082
  
  - service: http_status:404

# cloudflared再起動
systemctl restart cloudflared

Cloudflareダッシュボードで以下のDNSレコードを追加しました。

Talk専用のnginx vhostを作成し、port 9082でリスニングするよう設定しました。

# /etc/nginx/sites-available/talk.katuocloud.com
server {
    listen 9082;
    server_name talk.katuocloud.com;
    
    client_max_body_size 10G;
    
    # 完全にTalkを許可（セキュリティよりも動作優先）
    location / {
        proxy_pass http://127.0.0.1:9080;
        proxy_http_version 1.1;
        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 https;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Port 443;
        proxy_read_timeout 3600;
        proxy_send_timeout 3600;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

# シンボリックリンク作成
ln -sf /etc/nginx/sites-available/talk.katuocloud.com /etc/nginx/sites-enabled/

# nginx再起動
nginx -t
systemctl reload nginx

Nextcloud側でTalk専用ドメインを認識させ、ゲスト機能を有効化しました。

# trusted_domainsに追加
docker exec nextcloud-stack-app-1 php occ config:system:set trusted_domains 2 --value="talk.katuocloud.com"

# ゲスト機能有効化
docker exec nextcloud-stack-app-1 php occ config:app:set spreed enable_guests --value=yes

# 会話開始権限を全ユーザーに
docker exec nextcloud-stack-app-1 php occ config:app:set spreed start_conversations --value=0

# HTTPS強制認識
docker exec nextcloud-stack-app-1 php occ config:system:set overwriteprotocol --value="https"

# 招待リンク生成ドメインを固定
docker exec nextcloud-stack-app-1 php occ config:system:set overwritehost --value="talk.katuocloud.com"
docker exec nextcloud-stack-app-1 php occ config:system:set overwrite.cli.url --value="https://talk.katuocloud.com"
docker exec nextcloud-stack-app-1 php occ config:system:set spreed.baseUrl --value="https://talk.katuocloud.com"

# overwritecondaddr削除（動的判定を無効化）
docker exec nextcloud-stack-app-1 php occ config:system:delete overwritecondaddr

# JavaScriptキャッシュクリア
docker exec nextcloud-stack-app-1 rm -rf /var/www/html/data/appdata_*/js/*

原因: port 9000を手動起動したnohup python3 -m uvicornプロセスが占有していた。

解決策:

# 手動プロセスを停止
kill 78914

# 正規のsystemdサービスを起動
systemctl start mikyun-cloud.service

原因: nginx設定で/dist/、/custom_apps/パスが許可されていなかった。

解決策: 最終的に全パスを許可する設定に変更（location /）。

原因: Nextcloudのoverwrite.cli.urlがcloud.k2-o.netに設定されていた。

解決策:

# システム全体のoverwrite.cli.urlをtalk.katuocloud.comに変更
docker exec nextcloud-stack-app-1 php occ config:system:set overwrite.cli.url --value="https://talk.katuocloud.com"

# Talkアプリ側の設定を削除（システム設定を優先）
docker exec nextcloud-stack-app-1 php occ config:app:delete spreed overwrite.cli.url

原因: ブラウザとNextcloudのキャッシュが残っていた。

解決策:

# overwritehostを明示的に設定
docker exec nextcloud-stack-app-1 php occ config:system:set overwritehost --value="talk.katuocloud.com"

# overwritecondaddrを削除
docker exec nextcloud-stack-app-1 php occ config:system:delete overwritecondaddr

# JavaScriptキャッシュクリア
docker exec nextcloud-stack-app-1 rm -rf /var/www/html/data/appdata_*/js/*

# ブラウザ側: Ctrl+F5でスーパーリロード

'overwriteprotocol' => 'https',
'overwritehost' => 'talk.katuocloud.com',
'spreed.baseUrl' => 'https://talk.katuocloud.com',
'overwrite.cli.url' => 'https://talk.katuocloud.com',
'trusted_domains' => 
array (
  0 => 'cloud.k2-o.net',
  1 => 'files.wan-secure.net',
  2 => 'talk.katuocloud.com',
),

1. WireGuard VPNに接続
2. https://cloud.k2-o.net/ でNextcloudにログイン
3. Talkアプリを開く
4. 「新しい会話」でグループ会話を作成
5. 会話の設定（⚙️）→「ゲスト用リンクを共有」
6. 生成されたリンク（https://talk.katuocloud.com/call/xxxxx）をコピー
7. LINE、メール、SMS等で外部ユーザーに送信
8. 会話ルームで待機

1. 招待リンク（https://talk.katuocloud.com/call/xxxxx）をクリック
2. 名前を入力
3. 「会話に参加」をクリック
4. チャット・ビデオ通話が利用可能

• セキュリティ強化: nginx設定でTalk以外のエンドポイントへのアクセスを制限
• TURN/STUNサーバー設定: NAT越え通話の品質向上
• ゲスト参加ログ: 外部ゲストの参加履歴を記録する仕組み
• 料金プラン統合: katuocloud.comの「ゲスト招待ビデオ通話 +¥2,000/月」オプションとの連携