| Author: |
Kevin Lynx |
|---|
| Date: |
9.29.2011 |
|---|
| Contact: |
kevinlynx at gmail dot com |
|---|
本文描述如何使用Lisp工具集搭建一個完整的個人博客站點。一個搭建好的例子站點可以參看我的個人博客：http://codemacro.com。
要搭建一個獨立博客，需要兩方面的支持。一是博客軟件，二是根據選擇的博客軟件取得必須的“硬件“。例如我這里使用的是Lisp工具集，就需要一個可以完全控制的服務器，所以這里我需要一個VPS。當然，購買一個合適的域名也是必須的。以下將針對這些內容做描述。
獲取VPS及域名
VPS提供商國內國外都有很多。我選擇的是 rapidxen ，128M內存，1年70來美元，算是國外比較便宜的，速度上還過得去。
購買了VPS后，可以進入后臺管理頁面安裝VPS操作系統。同樣，因為我使用的是Lisp，我選擇安裝了Debian 6.0 squeeze (minimal)64位。實際上我更傾向于32位，因為我的PC系統就是32位，方便測試。安裝系統非常簡單，基本隨意設置下即可。值得注意的是，除了修改root密碼外，最好修改下ssh端口，具體設置方法可以另行搜索。此外，因為后面我會使用nginx作為HTTP前端服務器，為了方便安裝nginx，最好更新下軟件源列表，編輯etc/apt/source.list:
deb http://ftp.us.debian.org/debian squeeze main
deb http://packages.dotdeb.org stable all
deb-src http://packages.dotdeb.org stable all
deb http://php53.dotdeb.org stable all
deb-src http://php53.dotdeb.org stable all
購買VPS最主要的，就是獲取到一個獨立IP，如圖：
然后可以去購買域名。同樣，也有很多域名服務商。這里我選擇的是 godaddy ，我選擇的域名codemacro.com一年11美元。購買了域名后，就需要將域名和VPS IP關聯起來。詳細設置也可以另行搜索。這里簡要提下：在成功登入godaddy后，選擇My Account，進入自己的域名，選擇DNS Manager，然后添加域名映射即可，如圖：
通過以上設置后，你購買的域名就成功指向你購買的VPS地址了。可以通過ping來觀察是否指向成功。
使用Lisp構建博客系統
要在VPS上安裝軟件，首先需要SSH上你的VPS，例如：ssh -p 1234 root@codemacro.com。
這里使用的軟件集包括：
實際上，可以完全使用Lisp作為Web服務器，但我擔心效率問題（對個人博客而言完全沒這回事），所以使用了nginx作為Web服務器前端，將hunchentoot放在后面。
安裝nginx
在設置好debian軟件源后，安裝非常簡單:
apt-get install nginx
安裝完后，因為要將HTTP請求轉發給Lisp服務器，所以需要修改下配置:
vi /etc/nginx/sites-avaiable/default
將/請求派發給Lisp服務器（假設監聽于8000端口）:
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
然后可以啟動nginx了:
nginx
這個時候通過瀏覽器訪問，會得到503 bad gateway的錯誤提示，因為hunchentoot還沒開啟。
安裝Lisp相關軟件
SBCL 同樣可以通過apt直接安裝:
apt-get instal sbcl
裝好SBCL后，就可以進一步安裝 quicklisp 。可以完全遵守quicklisp官方給的安裝方法進行安裝。大概就是先獲取quicklisp.lisp文件，然后在SBCL中載入，根據提示即可。這里不再贅述。
安裝好quicklisp后，就可以使用它安裝很多Lisp軟件/庫了。quicklisp在安裝一個Lisp庫時，會自動下載并安裝依賴庫，就像apt-get一樣。因為ext-blog并未收入到quicklisp的軟件列表里，所以ext-blog需要手動安裝。首先，在本地（非VPS上）獲取ext-blog源碼:
git clone git://github.com/kevinlynx/klprj.git
上面的git是我個人存東西用的，暫時沒將ext-blog單獨放置。進入到ext-blog目錄。該目錄下有幾個方便的腳本可以用于博客管理。首先將ext-blog打包并上傳到VPS上，例如:
./upload-dist.sh root@codemacro.com 1234 /home/test
該腳本會調用make-dist.sh將ext-blog全部源碼打包，然后使用scp拷貝該文件及update-blog.sh到VPS指定的目錄里（這里是/home/test），然后ssh上VPS。期間會兩次輸入VPS系統的密碼。然后以下操作將在VPS上完成。
首先進入到剛才拷貝文件的目錄:
cd /home/test
解壓ext-blog.tar.gz:
tar xvf ext-blog.tar.gz
然后ext-blog被解壓到/home/test/dist目錄。進入此目錄運行SBCL:
cd dist
sbcl
ext-blog目錄下dep.lisp會使用quicklisp安裝依賴庫，進入SBCL后，載入該文件即可安裝所有依賴庫，這可能需要一點時間:
(load "dep.lisp")
在沒有其他問題下，可以暫時退出SBCL完成一些其他準備工作。
ext-blog在最近的版本中加入了驗證碼生成功能，這需要一個pcf字體文件。因為字體文件一般較大，所以upload-dist.sh腳本并沒有將該字體文件打包，所以這里需要手動復制，同樣在本地的ext-blog目錄下:
scp -P 1234 data/wenquanyi_12ptb.pcf root@codemacro.com:/home/test/dist/data/
另外，因為需要將Lisp解釋器放置在系統后臺執行，避免關掉SSH會話后終止SBCL進程，所以這里需要個工具gnu screen。可以使用apt-get來安裝:
apt-get install screen
然后，一切就OK了。在VPS上可以使用ext-blog目錄下的run-blog.sh來運行這個博客（首先確定VPS上的nginx開啟）:
./run-blog.sh
該腳本會使用screen在后臺開啟一個SBCL進程，并自動載入ext-blog，然后在8000端口上開啟HTTP服務。這個啟動過程可能會使用幾十秒的時間，直接ctrl+z退出screen，這并不終止SBCL。一段時間后便可在瀏覽器里測試。
設置博客
如果一切正常，此時通過瀏覽器訪問你的站點時，會被重定向到一個博客初始化頁面，如下：
上圖中我是在本機測試的，所以域名是localhost，希望不至于產生誤解。初始化僅需輸入用戶名和密碼即可，以后可通過該用戶名和密碼進入博客后臺管理頁面。完成這一步后，就可以進入博客后臺管理頁面做更多的設置，例如博客標題等。
ext-blog的管理頁面使用了emlog博客系統的CSS及其他資源，因此有同學覺得管理頁面很面熟就不奇怪了。ext-blog提供在線編輯博客功能，同時也支持簡單的metaweblog API，因此可以使用一些博客客戶端來發表文章（僅測過我自己寫的博客客戶端cl-writer）。
最后
本文描述較為粗略，主要是很多細節我自己也記不清。如有問題可以發郵件給我。