本文說明安裝 Zittme 的流程。環境大致分為兩種。

• 虛擬主機：向主機業者申請使用的環境。資料庫與網頁伺服器已經準備好，只要上傳檔案即可。
• 個人伺服器（VPS）：自行營運伺服器的環境。網頁伺服器與資料庫需自行準備。

您只要依照符合自身環境的一邊進行即可。從安裝精靈開始，兩種環境的步驟相同。

安裝環境

韓國國內虛擬主機（Cafe24、Dothome、Gabia 等）的 PHP 主機方案大多都能滿足。申請時若可選擇 PHP 版本，請選擇 8.2 以上。無論如何，安裝精靈的環境檢查步驟都會指出不足的項目。

下載發行版（共通）

請從 zitt.me 發行頁面下載最新發行版。目前 Beta 期間僅限登記為測試者的會員下載。

---

A. 安裝到虛擬主機

A-1. 確認資料庫資訊

虛擬主機在申請時會一併建立資料庫。請先在主機管理頁面（我的服務管理等）確認以下數值，安裝精靈中會直接輸入。

• 資料庫主機（通常為 localhost）
• 資料庫名稱
• 資料庫使用者名稱
• 資料庫密碼（申請時設定的值）

A-2. 上傳檔案

請先在您的電腦上解壓縮下載的發行版，再用 FTP 軟體（FileZilla 等）上傳到主機的網站根目錄。網站根目錄的資料夾名稱依業者而不同（www、public_html、html 等）。

• 檔案多達數萬個，FTP 上傳需要時間，而且 FTP 軟體在上傳數千個檔案時可能會漏掉一部分。若業者提供解壓縮功能（網頁檔案管理員），上傳 tgz/zip 後在伺服器上解壓縮會更快更安全。
• 上傳後請確認 index.php 位於網站根目錄的正下方。若像 zittme/index.php 這樣多了一層，就必須把資料夾內的內容移到網站根目錄。此時 .htaccess 等隱藏檔也要一起移動。
• 請在網站根目錄建立 files 資料夾，並在檔案管理員中將權限設為 707（或 777）。網站所有的上傳檔與快取都會存放在這個資料夾。

A-3. 連線

用瀏覽器連到您的網域（或主機提供的臨時網址），安裝精靈就會啟動。請前往下方「安裝精靈」一節。

大多數虛擬主機使用 Apache，發行版內附的 .htaccess 會自動處理短網址，不需要另外設定。

---

B. 安裝到個人伺服器（VPS）

以下以可透過 Shell（SSH）連線的伺服器為準。

B-1. 上傳檔案

tar xzf zittme-0.0.01.tgz -C /var/www/mysite
mkdir -p /var/www/mysite/files
chown -R www-data:www-data /var/www/mysite

網頁伺服器帳號（上例為 www-data）必須能寫入 files 資料夾，安裝才能進行。網站所有的上傳檔、快取與設定都會存放在這個資料夾。

B-2. 建立資料庫

CREATE DATABASE mysite DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mysite'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON mysite.* TO 'mysite'@'localhost';
FLUSH PRIVILEGES;

B-3. 網頁伺服器設定（nginx）

Zittme 提供 nginx 設定小幫手。

• 安裝精靈的環境檢查畫面：偵測伺服器環境，產生專屬設定與套用指令。
• 發行版中的 common/scripts/setup-nginx.sh：一次套用的指令碼。
• 設定範例：common/manual/server_config/zittme-nginx.conf

若使用 Apache，由發行版的 .htaccess 處理，只要啟用 mod_rewrite 即可。

---

安裝精靈（共通）

用瀏覽器連到網站網址，安裝精靈就會啟動。請依照畫面上方的步驟指示進行。

• 環境檢查：自動檢查伺服器是否符合需求。若有問題，會逐項顯示說明。
• 同意授權：Zittme 是 GPL v2 自由軟體。
• 輸入資料庫資訊：虛擬主機請填入 A-1 確認的值，個人伺服器請填入 B-2 建立的值。
• 建立管理員帳號：設定網站最高管理員的電子郵件與密碼。

安裝完成後，網站會連同預設選單（首頁・討論區）一起開啟，預設編輯器設為 zittEditor。

安裝後應確認的事項

• 管理員登入：your-site/admin
• 系統設定 > 基本設定：網站標題・預設語言・時區
• 管理畫面設定：管理選單位置（上方・左側・右側）、登錄管理員 Logo
• 確認檔案上傳：在討論區發表一篇文章並附加圖片試試看。若失敗，請確認 files/ 資料夾的寫入權限。虛擬主機可在檔案管理員中將權限調整為 707 或 755。

更新

管理員儀表板出現新版本通知時，請從發行頁面下載新的發行版並覆蓋。覆蓋後登入管理員，所需的資料庫變更會自動套用。更新前請務必備份 files/ 與資料庫。