作者: Jerry Lin

最近再找一款能夠方便架站自由度也高的管理面板，主要是為了架設 LEMP 的環境，於是找到這款 Hestiacp 。這是 Vestacp 的兄弟款，不過 Vestacp 已經沒有維護了。

先講結論：
這是一款學習門檻較高的 panel，建議提供給已經熟悉使用 debain / ubuntu 的管理員，可以做一個屬於自己的習慣的模版和 SOP，對於較為複雜的 LEMP 網站會滿方便的。但因為是開源的服務，導致還是不是很方便（和 aapanel 比較），對於習慣無 panel 操作的用戶還是會感覺到礙手礙腳的。

—
這款 Hestiacp 的好壞，個人分析如下：

優點：

1. Panel 最大的好處就是有許多配置都調整好了，不用費心客製化 LEMP 的各種參數。
2. 同樣使用 Panel 的好處之一：很多動作不用一堆指令，用網頁 UI 點一點就處理好了。
3. 這款 Hestiacp 許多套件安裝和配置是使用系統原生的實作方法， panel 實作安裝服務等也是很透明易懂，甚至提供開發文件。也是開源的。
4. 許多操作是原生的作法，會用 debain / ubuntu 的話會很方便，也不會有過多包裝，不用擔心學了以後其他 panel 或是轉換無 panel 等有學習障礙。
5. 有還在維護中的文件和論壇，而且 panel 也有繁體中文的翻譯可以使用。
6. 內建網站統計工具，是面向 MIS/SE 的一套統計服務。

缺點：

1. 使用 panel 都會有壞處就是：習慣使用 command line 的操作的話，要強迫自己有些需求要從 panel 上實現，要不 panel 沒有同步的話可能會有設定互相衝突覆蓋的問題。
2. Hestiacp 有部分設定在網頁上不方便操作，要用 v-xxxxx  等 panel 指令動作比較快處理，參考列表。學習門檻較高。
3. 文件管理器長的很醜，如果有需要還是推薦用 command line 處理比較舒服。
4. 開源的 Panel 要記得常更新，避免被 0day 攻擊，更新時要注意客製化的 template 等需要確保不會被更新覆蓋。
5. 客製化 http Service （Nginx / Apache）的樣版真的有夠麻煩。和 aapanel 的方便性差滿多的。
6. Hestiacp 建立 LEMP 套件需要事先安裝好，套件無法獨立安裝（會與面板衝突導致不顯示）。

Hestiacp 論壇： https://forum.hestiacp.com/
介紹：https://hestiacp.com/
文件：https://docs.hestiacp.com/
Github：https://github.com/hestiacp/hestiacp

支持系統：

• Debian 10
• Debian 11
• Ubuntu 18.04 LTS
• Ubuntu 20.04 LTS
• Ubuntu 22.04 LTS

— 以下架設和簡易心得 —

提醒下：有部分配置和安裝需要更詳細的測試，並非一個完整的安裝 SOP。

先登入root 權限，更新一遍

apt-get update

下載 install.sh

wget https://raw.githubusercontent.com/hestiacp/hestiacp/release/install/hst-install.sh

下載 install.sh

wget https://raw.githubusercontent.com/hestiacp/hestiacp/release/install/hst-install.sh

參考選定安裝（https://gabizz.github.io/hestiacp-scriptline-generator/）不安裝 mysql \ http server 做最小安裝，port 設定 8083：

sudo bash hst-install.sh --apache no --phpfpm no --multiphp no --vsftpd no --proftpd no --named yes --mysql no --postgresql no --exim yes --dovecot yes --sieve no --clamav yes --spamassassin no --iptables yes --fail2ban yes --quota no --api no --interactive yes --hostname no --email no --password no --with-debs no --port '8083' --lang 'zh-tw' --force

更新 Panel 網域（假設網域 cp-testing.69939.uk），記得 dns 要先設定上

v-change-sys-hostname cp-testing.69939.uk

Panel 網域補 SSL

v-add-letsencrypt-host

更改密碼

v-change-user-password admin 密碼

透過上述選定安裝，預設安裝的服務有這些：

後台新增一個用戶，設定方案為 default

點入該新增的帳號以後，選擇右上角登入該帳號之後，就可以創建其他網站。

再創建網站之前如果需要編輯 nginx 內容，需要編輯樣版，參考：https://docs.hestiacp.com/admin_docs/web.html#how-do-web-templates-work
Nginx 的路徑為：

/usr/local/hestia/data/templates/web/nginx/php-fpm/

檔案要記得複製一份新的並且命名好。避免更新 panel 的時候被覆蓋回去。

另外備註一些參考：

1. 面板的指令列表：https://github.com/hestiacp/hestiacp/tree/main/bin

有時下載一個 txt 文件，用文字編輯器打開來發現不是 utf8 編碼，但是不知道他是用了什麼編碼，這邊可以先丟到 chrome 瀏覽器看看，如果 chrome 瀏覽器顯示是正常的，就可以開啟 “開發者工具”，開啟”主控台”，輸入指令：

document.charset

就可以顯示目前的編碼名稱，如下圖所示：

這時如果想要儲存成常用編碼的檔案，這時可以用 sublime 3 或是其他可以轉換編碼的文字編輯器。

用 usblime 3 為例，如圖操作，先開啟指定編碼看是否正確，正確的話再另存編碼即可。

Update 2024-06-17

拜 AI 科技之賜，現在生成型的文字 AI 已經足以處理 php array 翻譯了，我使用 ChatGPT 付費版來處理翻譯，操作上就貼文件給他，直接下指令請他翻譯，參考：

ChatGPT

chatgpt.com

A conversational AI system that listens, learns, and challenges

— 舊文 —-

PHP 的多語系或是翻譯實作的形式各式各樣，像是 PO/MO 翻譯檔案、寫在 SQL 資料庫、靜態檔案或是寫在 PHP 檔案之中的作法，作法之多，從 PO/MO 檔案轉換的線上工具可以一窺一二。

這邊使用 Codeigniter 的語系系統，是用 PHP array 來處理的，這樣的形式要批次處理前置翻譯有點困難，如果要是用翻譯的 API 也要額外付費，於是用了一些比較迂迴的作法。

首先擁有的翻譯資源：

• Poedit 軟體。因為之前有需要大量使用 wordpress 功能，需要翻譯外掛和布景主題，所以有買斷一個個人使用版本。這套工具可用來翻譯 PO/MO 格式的檔案。
• LEMP 本地開發環境。

實作的 SOP 是這樣的：

1. 將翻譯的 PHP 檔案全部轉換/產生新的 PO 檔案。
2. 透過 Poedit 軟體做前置翻譯。
3. 透過軟體內建搜尋翻譯功能初步作一次調整。
4. 確認 PO 檔案放在和 PHP 檔案是同一個資料夾。
5. 取出將 PO 檔案翻譯內容，替換原 PHP檔案內容。
6. 做檢查微調。檢查 ‵/‵ 字符等兩個檔案，或是其他可能會有不同的地方。

附上其中 SOP 的 1. 和 5. 的檔案原始碼：

# php2po.php
<?php 

$PATH = dirname(__FILE__) . "/路徑";
$files = glob($PATH . '*.php');

foreach ($files as $file) {
    $lang = [];
    include $file;

    $fh = fopen($file . ".po", 'w');
    fwrite($fh, "#\n");
    fwrite($fh, "msgid \"\"\n");
    fwrite($fh, "msgstr \"\"\n");

    foreach ($lang as $key => $value) {
        $key = addslashes($key);
        $value = addslashes($value);
        fwrite($fh, "\n");
        fwrite($fh, "#. $key\n");
        fwrite($fh, "msgid \"$value\"\n");
        fwrite($fh, "msgstr \"$value\"\n");
    }
    fclose($fh);
}

# po2php.php
<?php
function get_replace_array($file)
{
    $input_lines = file_get_contents($file);
    preg_match_all('/msgid \"(.*)\"/', $input_lines, $msgids);
    preg_match_all('/msgstr \"(.*)\"/', $input_lines, $msgstrs);
    $arr = [];
    for ($i = 1; $i < count($msgids[1]); $i++) {
        // 第一個是空值
        $arr[$msgids[1][$i]] = $msgstrs[1][$i];
    }
    // var_dump($arr);die();
    return $arr;
}

$PATH = dirname(__FILE__) . "/路徑";
$files = glob($PATH . '*.php');

foreach ($files as $file) {
    $lang = [];
    include $file;

    $replace_array = get_replace_array($file . ".po");

    $php_file = file_get_contents($file);
    $_lang = [];
    foreach ($lang as $key => $value) {
        $_lang[$key] = $value;

        $value_tmp = addslashes($value);
        if (isset($replace_array[$value_tmp])) {
            $_lang[$key] = $replace_array[$value_tmp];
        }

        if ($value != $replace_array[$value]) {
            echo $key . ", " . $_lang[$key] . "
\n";
        }
    }

    file_put_contents($file, '<?php $lang = ' . var_export($_lang, true) . ';');
}

需要注意幾件事情：

1. 買斷版的 Poedit 也是有翻譯數量上限的，不過暫時夠用就是。
2. Poedit 在前置翻譯之前記得設定好語系，除了語系之外可以儘量讓檔案小一點，不用特別標記其他的 meta ，會產生多餘的註解檔案。
3. 在本機操作 PHP 轉換時要注意一下 RAM 是否夠用，
4. 檔案轉換的路徑需要自行調整，PO 檔案的命名是以原始 PHP 檔案直接加上 .po 副檔名。
5. 如果轉換出來的 po 檔案有問題無法開啟，建議放上 po editor online 上檢查看看，或是轉換一下下載繼續處理。
6. 如果真的無法翻譯，檔案量不大的話可以把變數拆行丟 google 翻譯 是可行的，要注意 key 值的命名規則，不要被翻譯了。

如果有需要信件 RWD 功能，現在有一個框架可用，叫做 mjml：

mjml.io

MJML – The Responsive Email Framework

The only framework that makes responsive email easy. MJML is a markup language designed to reduce the pain of coding a responsive email.

這裡有線上編輯器和各種模版可選擇：

mjml.io

Responsive Email Templates

Ready-to-use and free responsive email templates coded in MJML.

有時會需要更改 Mac 內建的 PHP 版本或是新增一個 PHP 來使用，這時候會需要使用 Homebrew 來安裝：

brew.sh

Homebrew

The Missing Package Manager for macOS (or Linux).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝好 Homebrew 之後，安裝 php 7.3 會發現已經不支援了，參考 stackoverflow 會得知需要用別的來源：

brew tap shivammathur/php

brew install shivammathur/php/[email protected]

注意 tap 動作只需要成功執行一次就行。

安裝時可能會遇到的注意事項：

1. 1. Xcode 會提示需要更新（如果都沒更新的話），只需要按照提示更新即可。
   2. 會得到 php 的位置資訊，例如我安裝以後得到的位置就是

      /usr/local/opt/[email protected]/bin/php

   3. 要確認 install 之後有沒有正確 link ，我需要兩個版本，原版本是 8.1.14 所以並不會正確執行，也沒有必要執行。參考這裡，另外建議檢查一下 ~/.bash_profile 之中有沒有指定 PATH。

2023-10-23 update:

現在 PHP 已經更新到 8.2 啦，上述 brew 的方式依然可以更新，安裝時更換版本號碼即可。安裝成功後檢查 ~/.bash_profile 的 PATH 更新為新版本，之後刷新指令 source ~/.bash_profile 就行的。

HTTrack 是一個砍站軟體，他在 windows 上有 GUI 介面，不過在 Mac 上只有 command line 介面，也不難處理，對於下載網頁的靜態資源還是不錯用的。

安裝和執行方法參考：

www.minwt.com

[MAC] HTTrack Website Copier砍站軟體!移植到MAC的安裝與使用教學

說到砍站軟體，大家第一印象不外乎就是HTTrackWebsiteCopier，說到這套砍站軟體，算是最老牌同時也是最簡易好上手的砍站軟體，說到這一個…

滿詳盡的，這邊就不贅述。

要注意的重點：

1. 使用 Homebrew 安裝，在教學網頁中第一步驟為安裝 Homebrew 過程。 Homebrew 官網參考請點這裡。
2. 有需要其他安裝版本的話可以參考官網下載（這塊沒特別試過，請小心服用）。
3. 雖然是廢話，不過還是要提醒一下，砍站軟體並不能完整複製網頁/網站，並非砍下來直接打開看就是一模一樣的。