環境與版本
- 作業系統:CentOS 5.1 (32/64 位通用)
- 目標運行時:Mono 2.6.3 (支援 .NET 2.0/3.5)
- Web 整合:mod_mono 2.6.3 (Apache 模組) + xsp 2.6.3 (獨立測試伺服器)
- 安裝前綴:
/opt/mono (避免污染系統預設路徑)
前置依賴安裝
yum install gcc bison pkgconfig glib2-devel gettext make httpd-devel \
gcc-c++ libstdc++-devel
源碼獲取與解壓
cd /root/mydir # 或 /usr/local/src
wget https://ftp.novell.com/pub/mono/sources/mono/mono-2.6.3.tar.bz2
wget https://ftp.novell.com/pub/mono/sources/mod_mono/mod_mono-2.6.3.tar.bz2
wget https://ftp.novell.com/pub/mono/sources/xsp/xsp-2.6.3.tar.bz2
tar -jxvf mono-2.6.3.tar.bz2
tar -jxvf xsp-2.6.3.tar.bz2
tar -jxvf mod_mono-2.6.3.tar.bz2
編譯安裝順序 (嚴格依賴順序)
1. Mono 核心運行時
cd mono-2.6.3
./configure --prefix=/opt/mono
make
make install
# 環境變數持久化
echo 'export PKG_CONFIG_PATH=/opt/mono/lib/pkgconfig:$PKG_CONFIG_PATH' >> ~/.bash_profile
echo 'export PATH=/opt/mono/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
# 驗證
mono --version # 應輸出 Mono JIT compiler version 2.6.3
2. xsp 測試伺服器
cd ../xsp-2.6.3
./configure --prefix=/opt/mono
make
make install
# 快速測試
cd /opt/mono/lib/xsp/test
xsp4 --port 8088 --root .
# 瀏覽器訪問 https://server_ip:8088 驗證 ASP.NET 頁面渲染
3. mod_mono Apache 模組
# 尋找 apr-config 路徑 (通常為 /usr/bin/apr-1-config)
find / -name 'apr*config'
cd ../mod_mono-2.6.3
./configure --prefix=/opt/mono \
--with-mono-prefix=/opt/mono \
--with-apr-config=/usr/bin/apr-1-config
make
make install
# 複製生成的配置片段至 Apache 配置目錄
cp /etc/httpd/conf.d/mod_mono.conf /etc/httpd/conf/mod_mono.conf
# 注意:原文路徑有誤,正確應為 cp /etc/httpd/conf.d/mod_mono.conf /etc/httpd/conf.d/ (已存在) 或 include 至 httpd.conf
SELinux 與防火牆配置
# 允許 httpd 存取 mod-mono-server 進程 (SELinux 布林值)
setsebool -P httpd_disable_trans=1
# 開放 80 端口 (臨時關閉防火牆測試)
service iptables stop
# 生產環境建議精確開放:
# iptables -I INPUT -p tcp --dport 80 -j ACCEPT
# service iptables save
Apache 整合驗證
# 重啟 Apache 載入 mod_mono
service httpd restart
# 建立測試站點
mkdir -p /var/www/html/aspnet_test
cat > /var/www/html/aspnet_test/default.aspx <<'EOF'
<%@ Page Language="C#" %>
EOF
# 配置 VirtualHost (片段)
#
# ServerName mono.test.local
# DocumentRoot /var/www/html/aspnet_test
# MonoServerPath /opt/mono/bin/mod-mono-server4
# MonoDebug true
# MonoSetEnv MONO_IOMAP=all
# AddHandler mono .aspx .ashx .asmx .ascx .asax .config
# DirectoryIndex default.aspx
#
service httpd reload
# 瀏覽器訪問 https://mono.test.local/ 驗證
常見坑點與修正
--with-pcre 指向源碼解壓目錄而非安裝目錄,否則 configure 報錯找不到 pcre.h。
- SELinux 預設阻擋 httpd 執行 mono 進程,
httpd_disable_trans=1 為最簡暴力解法;生產環境建議編寫專用 TE 模組。
- Apache 2.2/2.4 需確認
LoadModule mono_module modules/mod_mono.so 已載入。
- Mono 版本需與 .NET 目標框架版本對應:2.6.x 對應 .NET 2.0/3.5;.NET 4.x 需 Mono 4.x+。