Keila项目裸金属服务器部署指南

Keila作为一个开源的邮件营销平台，虽然官方推荐使用Docker部署，但很多用户出于安全性和资源利用率的考虑，更倾向于直接在裸金属服务器上进行安装。本文将详细介绍如何在非Docker环境下部署Keila邮件营销系统。

系统环境准备

首先需要确保服务器满足以下基础环境要求：

1. 操作系统：推荐使用Debian/Ubuntu等Linux发行版
2. Erlang/Elixir环境：Keila基于Elixir开发，需要先安装Erlang运行时
3. Node.js环境：用于前端资源构建
4. PostgreSQL数据库：作为Keila的后端存储

在Debian/Ubuntu系统上可以通过以下命令安装基础依赖：

sudo apt update
sudo apt install -y erlang-dev elixir nodejs npm postgresql

获取Keila源代码

有两种方式获取Keila的源代码：

1. 从GitHub发布版下载：

wget https://github.com/pentacent/keila/releases/download/vX.X.X/keila-X.X.X.tar.gz
tar -xzf keila-X.X.X.tar.gz
cd keila-X.X.X

2. 从Git仓库克隆（适合需要最新开发版的用户）：

git clone https://github.com/pentacent/keila.git
cd keila

构建Keila应用

Keila的构建过程分为前端资源构建和Elixir应用编译两部分：

1. 安装JavaScript依赖：

npm ci --prefix ./assets

2. 获取Elixir依赖：

mix deps.get

3. 编译应用：

MIX_ENV=prod mix compile

4. 生成静态资源：

MIX_ENV=prod mix assets.deploy

5. 生成数据库迁移文件：

MIX_ENV=prod mix ecto.migrations

数据库配置

Keila使用PostgreSQL作为后端数据库，需要预先创建数据库和配置用户：

1. 创建数据库用户：

sudo -u postgres createuser keila

2. 创建数据库：

sudo -u postgres createdb -O keila keila_prod

3. 设置数据库密码：

sudo -u postgres psql -c "ALTER USER keila WITH PASSWORD 'your_secure_password';"

应用配置

Keila通过环境变量进行配置，建议创建一个专用的配置文件：

1. 创建.env文件：

cat > .env <<EOF
DB_URL=ecto://keila:your_secure_password@localhost/keila_prod
SECRET_KEY_BASE=$(mix phx.gen.secret)
HOST=yourdomain.com
PORT=4000
EOF

2. 加载环境变量：

set -a; source .env; set +a

数据库迁移

在应用启动前需要执行数据库迁移：

MIX_ENV=prod mix ecto.migrate

创建系统服务

为了确保Keila能够稳定运行，建议创建systemd服务：

1. 创建服务文件：

sudo tee /etc/systemd/system/keila.service > /dev/null <<EOF
[Unit]
Description=Keila Mail Service
After=network.target postgresql.service

[Service]
User=keila
Group=keila
WorkingDirectory=/path/to/keila
EnvironmentFile=/path/to/keila/.env
ExecStart=/usr/bin/mix phx.server
Restart=always

[Install]
WantedBy=multi-user.target
EOF

2. 启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable keila
sudo systemctl start keila

反向代理配置

建议使用Nginx作为反向代理，提供HTTPS支持和更好的性能：

server {
    listen 443 ssl;
    server_name yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:4000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

安全建议

1. 专用用户：为Keila创建专用系统用户，避免使用root权限运行
2. 防火墙：确保只开放必要的端口（如443）
3. 定期备份：设置数据库和应用数据的定期备份机制
4. 更新策略：定期检查并更新Keila版本

通过以上步骤，您可以在裸金属服务器上成功部署Keila邮件营销系统，无需依赖Docker环境。这种部署方式虽然配置步骤较多，但可以提供更好的性能控制和资源利用率。