主要ファイル配置

// FILE LAYOUT — 最終更新: 2026-05-14 / maguro Docker 統合後の最新版

運用中 maguro Docker 中心 + R640 公開フロント + hirame Collabora

1. ポータル・VPNエンジン関連 (maguro)

ファイル / パス	役割
`/opt/mikyun-portal/`	Docker bind ソース (ホスト側)
`/opt/mikyun-portal/docker-compose.yml`	compose 定義 (image: `mikyun-portal:1.1`, ports 9000 + 9081)
`/opt/mikyun-portal/.env`	DB/Admin/Stripe 秘匿値 (mode 600 root)
`/opt/mikyun-portal/app/main.py`	FastAPI エントリ + Basic認証ミドルウェア
`/opt/mikyun-portal/app/ui_admin.py`	運営UI (/ui) — 認証付き
`/opt/mikyun-portal/app/client/client_ui.py`	顧客UI (/client)
`/opt/mikyun-portal/app/api_users.py`	`/api/users` JSON API (Basic認証)
`/opt/mikyun-portal/mikyun_vpn_engine.py`	VPN Engine 本体 :9081 (IP採番 / WG設定生成 / NC操作)
`/opt/mikyun-portal/billing/billing_daily.py`	月次ポイント消費・suspend 処理 (2026-04-10〜)
`/opt/mikyun-portal/scripts/collect_file_count.py`	NC 使用量集計 (cron 1h)
`/opt/mikyun/output/client-configs/`	発行済 conf 置き場
`/opt/mikyun/output/qr/`	発行済 QR PNG 置き場

旧パスは無効: 旧 R640 ホストの /root/mikyun-cloud/, /root/mikyun-cloud/mikyun-portal/, /root/mikyun-cloud/app/ はすべて R640 再構築 (2026-05-14) で消滅。現行は maguro /opt/mikyun-portal/ 一本。

2. WireGuard 関連 (maguro)

ファイル / パス	役割
`/etc/wireguard/wg-clients.conf`	顧客VPN (10.200.0.0/16, UDP 54024)
`/etc/wireguard/wg-customers.conf`	業務カスタマー (UDP 61001)
`/etc/wireguard/wg-storage.conf`	ストレージ用 (UDP 62001)
`/etc/wireguard/peers/`	各ピア秘密鍵/公開鍵 (mode 600)
`/etc/wireguard-r640-snapshot/` (R640側)	旧 R640 wg0/wg1/wg2 退避 (緊急復活用)

採番サブネット: 主に 10.200.0.0/16 (wg-clients)。旧 10.251.0.0/24 shared subnet は段階的に統合中。

3. Nextcloud 関連 (maguro)

ファイル / パス	役割
`/opt/nextcloud/compose/compose.yml`	NC stack 定義 (`compose-app-1` + `compose-cron-1` + `compose-db-1` + `compose-redis-1`)
`/opt/nextcloud/compose/.env`	NC秘匿値
`/srv/storage/nextcloud-data/`	NC データ実体 (Supermicro / LUKS+bcache+XFS / 64TB空き)
(Docker内) `/home/xs273132/wanchance.com/public_html/config/config.php`	NC config.php
`/etc/nginx/sites-enabled/cloud.k2-o.net`	maguro 終端 vhost (443)
`/etc/nginx/sites-enabled/admin.wan-secure.net`	運営ポータル vhost (WG必須)
`/etc/nginx/sites-enabled/office.wan-secure.net`	WG必須業務向け vhost

旧 R640 経路: 旧 R640 ホストの /root/nextcloud-stack/compose.yml および /mnt/maguro/nextclouddata (NFS マウント) は 2026-05-14 で廃止。 NC 終端は完全に maguro 単独で実行。 R640 は cloud.k2-o.net 行きの TCP を nginx stream + ssl_preread で SNI passthrough するだけ。

4. R640 (DMZ公開フロント) 関連

ファイル / パス	役割
`/etc/nginx/nginx.conf` + `/etc/nginx/stream.d/`	stream module + ssl_preread (SNI router)
`/etc/nginx/sites-enabled/katuocloud.com`	WP 公開 vhost (inner 127.0.0.1:8443)
`/var/www/katuocloud/`	WordPress 本体 (旧 xserver VPS から rsync 移行)
`/var/www/katuocloud/wp-content/themes/astra-child/functions.php`	申し込み/決済連携 (ポイント課金対応済)
`/var/www/katuocloud/wp-config.php`	WP DB接続 + `HTTP_X_FORWARDED_PROTO` 対応
`/mnt/data/`	LUKS auto-unlock 3.3T (バックアップ + WP)
`/mnt/data/backup/wp/katuocloud_wp/*.sql.gz`	WP DB 日次バックアップ (14日保持)
`/etc/cryptsetup-keys.d/data.key`	LUKS auto-unlock キーファイル

R640 の旧 NC 関連 (旧 /root/nextcloud-stack/, NFS mount 等) は再構築で完全消失。

5. Collabora (hirame) 関連

ファイル / パス	役割
`/home/hirame/collabora/docker-compose.yml`	Docker compose (`collabora/code 25.04.9.4`)
compose内 `extra_hosts`	`cloud.k2-o.net:173.0.0.5` (maguro fabric 直結)
外向き	maguro `nginx` → Collabora :9980 (hirame 173.0.0.6 経由)

fabric直結 (2026-05-14): 旧経路 (R640 SNI 迂回) は廃止。 Collabora ⇄ maguro NC は 173.0.0.4/30 サブネット直結 (1 hop)。 NC の wopi_allowlist は 173.0.0.4/30, 173.0.0.8/30, 119.26.175.225 のみ許可。

6. systemd / cron (maguro)

ユニット / cron	用途
`supermicro-watch.timer` (5min)	md0 / storage 90%+ / NFS / ATA / LUKS×5 監視 → Telegram
`mdadm-watch.timer` (5min)	/proc/mdstat md0 状態変化
`raid-watch.timer` (5min)	IPMI SEL (Drive Fault/Rebuild)
`cert-watch` cron 06:30	LE 全証明書 <14日警告/失効
`billing-daily.timer` 00:30	ポイント月次消費 → warning → suspended
`collect-file-count` cron 毎時0分	NC 使用量集計
NC backup cron	maguro `/srv/storage/SM-storage/backup/nextcloud/` へ世代保管

7. systemd / cron (R640)

ユニット / cron	用途
`perc-watch.timer` (5min)	SAS×8 + NVMe×2 (smartctl megaraid) + kernel megaraid event
`cert-watch` cron 06:30	LE 全証明書
`wp-katuocloud-db-backup` cron 02:30	WP DB dump 失敗 + サイズ異常 → Telegram

参考: パス対照表 (旧 → 新)

項目	旧 (R640 ホスト)	新 (maguro Docker, 2026-05-14)
mikyun-portal ソース	`/root/mikyun-cloud/mikyun-portal/`	`/opt/mikyun-portal/`
NC compose	`/root/nextcloud-stack/compose.yml`	`/opt/nextcloud/compose/compose.yml`
NC データ	R640 `/mnt/maguro/nextclouddata` (NFS)	maguro `/srv/storage/nextcloud-data/`
MariaDB	R640 ホスト 127.0.0.1:3306	maguro Docker `compose-db-1` (内部のみ)
WG	R640 `/etc/wireguard/wg{0,1,2}.conf`	maguro `/etc/wireguard/wg-{clients,customers,storage}.conf`
VPS バックホール	R640 wg2 → 162.43.8.20	削除 (6月末 VPS 解約予定)

2026-05-14 完了状態: 全運用パスは maguro 中心 + R640 公開フロント + hirame Collabora に整理済。旧 R640 ホスト上のサービスファイルは全て退役、ソースも消失。メンテは「maguro /opt/」「R640 /etc/nginx/ + /var/www/katuocloud/」「hirame /opt/collabora/」の3本柱。