# 程式碼解釋筆記：pidi 伺服器 Apache 虛擬主機與 DocumentRoot 對照

## 1. 元資料

- 筆記日期：2026-07-10
- 對應問題（使用者原問）：查詢目前 SSH 連線之 server（`192.168.1.241`）上所有 Apache 虛擬目錄／虛擬主機。
- 主要程式位置：遠端 `/etc/apache2/sites-enabled/*`（非本 repo 程式；以下為伺服器設定查詢結果）
- 連線方式：`ssh root@192.168.1.241`（見 `md/連線方式.txt`）
- 查詢指令：
  - `apache2ctl -S` — 列出 VirtualHost 與設定檔對應
  - `grep -hE 'ServerName|DocumentRoot|Alias ' /etc/apache2/sites-enabled/*` — 列出網域與實體目錄

## 2. 一句總結

這台 **TurnKey Linux / Debian 7**（主機名 `pidi`，IP `192.168.1.241`）的 Apache 依 **網域名稱 + 連接埠** 分成多個 VirtualHost；每個網域透過 `DocumentRoot` 指向 `/home/` 下各專案目錄，**msnew 與 tsaiku 共用同一目錄**，且本次查詢**未發現 `Alias` 子路徑別名**。

## 3. 分段說明

### 3.1 在做什麼

Apache 以 `<VirtualHost>` 區塊區分不同網站。`apache2ctl -S` 顯示「哪個網域 → 哪個設定檔」；`grep DocumentRoot` 顯示「哪個網域 → 哪個實體資料夾」。HTTP（80）與 HTTPS（443）各有一組設定，故同一網域在 grep 輸出中會出現兩次，實際目錄相同。

### 3.2 連接埠與站台分佈

| 連接埠 | 用途                 | 站台數 |
|--------|----------------------|--------|
| 12322  | phpMyAdmin（非標準） | 1      |
| 443    | HTTPS 虛擬主機       | 11     |
| 80     | HTTP 虛擬主機        | 12     |

- **80／443 預設站台（default server）**：`api.pidi.com.tw`（設定檔 `api`）
- **phpMyAdmin**：`pidi.com.tw`，port **12322**，DocumentRoot `/usr/share/phpmyadmin/`

### 3.3 網域 → 實體目錄完整對照

| 網域                               | ServerAlias（別名）            | DocumentRoot（實體目錄）                 |
|------------------------------------|--------------------------------|------------------------------------------|
| api.pidi.com.tw                    | —                              | /home/api/public_html                    |
| dormitory.pidi.com.tw              | dormitory1.pidi.com.tw         | /home/dormitory/public_html              |
| funapi.pidi.com.tw                 | —                              | /home/funglish_api                       |
| funglish.pidi.com.tw               | —                              | /home/funglish/public_html               |
| msnew.pidi.com.tw                  | msnew1.pidi.com.tw             | /home/msnew/public_html                  |
| tsaiku.pidi.com.tw                 | tsaiku1.pidi.com.tw            | /home/msnew/public_html（與 msnew 共用） |
| payment.pidi.com.tw                | payment1.pidi.com.tw           | /home/payment/public_html                |
| www.pidi.com.tw                    | www1.pidi.com.tw               | /home/pidiweb/public_html                |
| teacher.pidi.com.tw                | —                              | /home/teacher/public_html                |
| tchapi.pidi.com.tw                 | —                              | /home/teacher_api                        |
| test_am.pidi.com.tw                | test_am1.pidi.com.tw           | /home/wei/test_invoice/am/public_html    |
| test_xinchu.pidi.com.tw            | test_xinchu1.pidi.com.tw       | /home/wei/test_invoice/xinchu/public_html    |
| pidi.com.tw（phpMyAdmin，port 12322） | —                              | /usr/share/phpmyadmin/                       |

### 3.4 依實體目錄分組

| 實體目錄                                   | 對應網域                              |
|--------------------------------------------|---------------------------------------|
| /home/api/public_html                      | api.pidi.com.tw                       |
| /home/dormitory/public_html                | dormitory.pidi.com.tw                 |
| /home/funglish_api                         | funapi.pidi.com.tw                    |
| /home/funglish/public_html                 | funglish.pidi.com.tw                  |
| /home/msnew/public_html                    | msnew.pidi.com.tw、tsaiku.pidi.com.tw |
| /home/payment/public_html                  | payment.pidi.com.tw                   |
| /home/pidiweb/public_html                  | www.pidi.com.tw                       |
| /home/teacher/public_html                  | teacher.pidi.com.tw                   |
| /home/teacher_api                          | tchapi.pidi.com.tw                    |
| /home/wei/test_invoice/am/public_html      | test_am.pidi.com.tw                   |
| /home/wei/test_invoice/xinchu/public_html  | test_xinchu.pidi.com.tw               |
| /usr/share/phpmyadmin/                     | pidi.com.tw（phpMyAdmin）             |

### 3.5 依設定檔分組（VirtualHost 來源）

| 設定檔                         | 包含網域                                      | 備註                          |
|--------------------------------|-----------------------------------------------|-------------------------------|
| api                            | api.pidi.com.tw（80 + 443）                   | 80／443 皆為 default server   |
| dormitory                      | dormitory.pidi.com.tw                         |                               |
| funapi.pidi.com.tw.conf        | funapi.pidi.com.tw                            |                               |
| funglish / funglisg *.conf     | funglish.pidi.com.tw                          | 80 檔名疑似拼錯 funglisg      |
| msnew                          | msnew.pidi.com.tw、tsaiku.pidi.com.tw         | 同一檔案內兩組 VirtualHost    |
| payment                        | payment.pidi.com.tw                           |                               |
| pidiweb                        | www.pidi.com.tw                               |                               |
| teacher.pidi.com.tw.conf       | teacher.pidi.com.tw                           |                               |
| tchapi.pidi.com.tw.conf        | tchapi.pidi.com.tw（80）                      |                               |
| webmin.1657458378.conf         | tchapi.pidi.com.tw（443）                     | Webmin 自動產生               |
| test_invoice                   | test_am、test_xinchu（僅 80）                 | 測試站台                      |
| phpmyadmin                     | pidi.com.tw（port 12322）                     |                               |

### 3.6 分支與邊界案例

- **API 與官網分離**：`funapi` → `/home/funglish_api`；`funglish` → `/home/funglish/public_html`；`tchapi` → `/home/teacher_api`；`teacher` → `/home/teacher/public_html`。
- **共用 DocumentRoot**：`msnew.pidi.com.tw` 與 `tsaiku.pidi.com.tw` 皆指向 `/home/msnew/public_html`，應用程式可能依 `ServerName` 分支。
- **測試環境**：`test_am`、`test_xinchu` 位於 `/home/wei/test_invoice/` 下，且僅出現在 HTTP（80），無 HTTPS（443）條目。
- **無 Alias**：grep 未命中 `Alias`，表示無 `/子路徑` → 資料夾 這類虛擬目錄別名（phpMyAdmin 為獨立 VirtualHost，非 Alias）。

## 4. 關鍵程式碼引用（精簡）

連線方式（本 repo）：

```1:1:md/連線方式.txt
ssh root@192.168.1.241
```

遠端查詢指令（於 SSH 內執行，非 repo 檔案）：

```bash
apache2ctl -S
grep -hE 'ServerName|DocumentRoot|Alias ' /etc/apache2/sites-enabled/*
```

## 5. 名詞與假設

| 名詞／假設       | 說明                                                         |
|------------------|--------------------------------------------------------------|
| VirtualHost      | Apache 依網域／埠分流請求到不同站台設定                      |
| DocumentRoot     | 該 VirtualHost 的網站根目錄（實體檔案路徑）                  |
| ServerAlias      | 與 ServerName 等效的別名網域（如 `www1.pidi.com.tw`）        |
| NameVirtualHost  | 同一埠上依 Host 標頭區分多個網域                             |
| default server   | 無法匹配其他 ServerName 時的 fallback（本機為 api.pidi.com.tw） |
| Alias            | URL 子路徑對應到另一實體目錄；本次查詢未出現                 |

## 6. 仍待確認／後續可讀

- `funglish` 在 80 與 443 的設定檔檔名不一致（`funglish` vs `funglisg`），若 HTTP 異常可優先檢查。
- `tchapi` 的 HTTPS 由 `webmin.1657458378.conf` 管理，與 `tchapi.pidi.com.tw.conf` 分開，變更時需注意兩檔同步。
- 若需查 `<Directory>` 權限或 rewrite 規則，可再執行：`grep -rnE '<Directory |RewriteRule' /etc/apache2/sites-enabled/`。
- 本筆記為 **2026-07-10** 當下查詢快照；新增站台或改 DocumentRoot 後需重新執行上述指令更新。
