iCtrl项目在Ubuntu服务器上的完整部署指南

前言

iCtrl是一个功能强大的远程控制解决方案，本文将详细介绍如何在Ubuntu 22.04服务器上使用Apache2部署iCtrl系统。本指南适合有一定Linux基础的系统管理员或开发者参考。

环境准备

系统要求

• Ubuntu Server 22.04 LTS
• 至少2GB内存
• 10GB可用磁盘空间
• 稳定的网络连接

基础依赖安装

首先更新系统并安装必要组件：

sudo apt update
sudo apt install git apache2 python3-pip libapache2-mod-wsgi-py3 libssl-dev -y

启用WSGI模块（这是Python Web应用与Apache交互的关键组件）：

sudo a2enmod wsgi

安全配置

创建专用用户

为iCtrl创建专用系统用户是安全最佳实践：

sudo useradd ictrl
sudo usermod -a -G www-data ictrl
sudo chsh ictrl  # 将shell改为/bin/bash

目录权限设置

sudo chown -R www-data:www-data /var/www
sudo chmod -R 775 /var/www

获取iCtrl源代码

cd /var/www
git clone <iCtrl仓库地址> ictrl

构建环境

Python虚拟环境

cd /var/www/ictrl
python3 -m pip install --user virtualenv
python3 -m virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

前端构建

确保已安装Node.js：

cd client
npm install
npm run build

WebSocket支持

cd /var/www/ictrl
git submodule init
git submodule update
cd application/websockify-other/c
make

Apache配置

创建配置文件/etc/apache2/sites-available/ictrl.conf：

<VirtualHost *:80>
    ServerName yourdomain.com

    DocumentRoot /var/www/ictrl/client/build

    WSGIDaemonProcess ictrl_srv user=ictrl threads=20
    WSGIScriptAlias /api /var/www/ictrl/ictrl_srv.wsgi

    <Directory /var/www/ictrl>
        WSGIProcessGroup ictrl_srv
        WSGIApplicationGroup %{GLOBAL}
        Require all granted
    </Directory>

    LogLevel warn
    ErrorLog ${APACHE_LOG_DIR}/ictrl_error.log
    CustomLog ${APACHE_LOG_DIR}/ictrl_custom.log combined
</VirtualHost>

启用站点：

sudo a2ensite ictrl
sudo systemctl reload apache2

HTTPS安全配置

1. 获取SSL证书（推荐使用Let's Encrypt）
2. 将证书复制到项目目录：

cd /var/www/ictrl
sudo cp /path/to/cert/fullchain.pem .
sudo cp /path/to/cert/privkey.pem .
sudo chown www-data:www-data fullchain.pem privkey.pem

数据库配置

PostgreSQL安装

sudo apt install postgresql postgresql-contrib -y
sudo passwd postgres  # 设置密码

修改/etc/postgresql/14/main/pg_hba.conf：

# IPv4 local connections:
host    all             all             127.0.0.1/32            trust
# IPv6 local connections:
host    all             all             ::1/128                 trust

重启PostgreSQL服务：

sudo systemctl restart postgresql

iCtrl服务配置

编辑/var/www/ictrl/ictrl.conf：

# 数据库配置
DBPASSWD=your_password
DBADDR=localhost:5432

# 邮件服务配置
SENDER_SERVER=smtp.example.com
SENDER_PORT=587
SENDER_EMAIL=[e-mail]
SENDER_PASSWD=email_password

# SSL证书路径
SSL_CERT_PATH=/var/www/ictrl/fullchain.pem
SSL_KEY_PATH=/var/www/ictrl/privkey.pem

常见问题排查

1. 权限问题：确保所有文件和目录的所有者为www-data
2. WSGI错误：检查Apache错误日志获取详细信息
3. 数据库连接失败：验证pg_hba.conf配置和密码是否正确
4. 前端资源加载失败：确认build目录已正确生成

性能优化建议

1. 对于高并发场景，增加WSGIDaemonProcess的线程数
2. 考虑使用Nginx作为前端代理处理静态文件
3. 启用数据库连接池
4. 配置适当的缓存策略

结语

通过以上步骤，您已经成功在Ubuntu服务器上部署了iCtrl系统。建议在正式环境中部署前进行充分测试，并根据实际需求调整配置参数。定期检查系统日志和更新组件是保持系统稳定运行的关键。