Crater 发票管理系统部署教程

Crater 是一款简洁优雅的开源发票管理系统，基于 Laravel 和 Vue.js 构建。它专注于核心的发票和费用管理功能，界面清晰易用，特别适合自由职业者和小型工作室。支持多币种、多税率、自定义发票模板和客户门户等功能。本教程将在搬瓦工 VPS 上通过 Docker 部署 Crater。

一、Crater 核心功能

发票创建：专业的发票创建界面，支持多项目、折扣和多税率配置，自动编号。
估价单：创建项目估价发送给客户，批准后直接转为正式发票。
付款记录：记录和追踪每笔付款，支持部分付款和多种支付方式。
费用管理：记录业务支出，分类统计，支持附件上传（如收据照片）。
客户门户：客户可以通过独立的门户查看发票、付款历史和下载文档。
报表系统：销售报表、费用报表、利润报表和税务报表。
自定义字段：为发票和客户添加自定义字段，满足特殊业务需求。

二、环境准备

操作系统：Ubuntu 20.04+（推荐 Ubuntu 22.04）。
内存：至少 1GB RAM。
磁盘：至少 5GB 可用空间。
Docker：已安装 Docker 和 Docker Compose（参考 Docker 安装教程）。

选购搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受 6.77% 折扣。

三、Docker Compose 部署

3.1 创建项目目录

mkdir -p /opt/crater && cd /opt/crater

3.2 创建 Docker Compose 文件

cat > docker-compose.yml <<'EOF'
version: '3.8'

services:
  crater:
    image: bytefury/crater:latest
    container_name: crater
    restart: always
    ports:
      - "8080:80"
    environment:
      APP_URL: "http://your-domain.com"
      DB_CONNECTION: mysql
      DB_HOST: db
      DB_PORT: 3306
      DB_DATABASE: crater
      DB_USERNAME: crater
      DB_PASSWORD: your_db_password
      MAIL_DRIVER: smtp
      MAIL_HOST: smtp.example.com
      MAIL_PORT: 587
      MAIL_USERNAME: your-email@example.com
      MAIL_PASSWORD: your-email-password
      MAIL_FROM_ADDRESS: noreply@example.com
      MAIL_FROM_NAME: Crater
    volumes:
      - crater_storage:/var/www/html/storage
    depends_on:
      - db

  db:
    image: mysql:8.0
    container_name: crater-db
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: crater
      MYSQL_USER: crater
      MYSQL_PASSWORD: your_db_password
    volumes:
      - mysql_data:/var/lib/mysql
    command: --default-authentication-plugin=mysql_native_password --character-set-server=utf8mb4

volumes:
  crater_storage:
  mysql_data:
EOF

3.3 启动服务

docker compose up -d
docker compose logs -f crater

启动后访问 http://你的服务器IP:8080 按照安装向导完成配置，包括公司信息和管理员账户设置。

四、Nginx 反向代理

cat > /etc/nginx/sites-available/crater <<'EOF'
server {
    listen 80;
    server_name billing.example.com;

    client_max_body_size 20m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF

ln -s /etc/nginx/sites-available/crater /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d billing.example.com

五、使用 Crater

5.1 公司设置

登录后进入设置页面，完善公司名称、地址、Logo 和联系方式。配置发票编号前缀和格式、默认付款条件（如 Net 30 天）、货币和税率。Crater 支持配置多种税率和复合税率。

5.2 客户管理

在客户模块添加客户信息，包括公司名称、联系人、邮箱、电话和地址。每个客户有独立的详情页面，展示所有相关的发票、付款和费用记录，方便了解客户的交易历史。

5.3 创建和发送发票

点击创建发票，选择客户，添加服务项目（描述、数量、单价），设置税率和折扣。预览确认后通过邮件发送给客户。客户收到邮件后可以查看发票 PDF 并下载。Crater 提供多种发票模板可供选择。

5.4 报表分析

报表模块提供收入趋势、费用分类、利润分析和税务汇总等多维度数据。支持按时间范围筛选和导出 PDF 报表。仪表板页面直观展示未付发票金额、本月收入和费用等关键指标。

六、备份与升级

# 备份数据库
docker exec crater-db mysqldump -u crater -pyour_db_password crater > /opt/crater/backup_$(date +%Y%m%d).sql

# 备份存储文件
docker cp crater:/var/www/html/storage /opt/crater/storage_backup_$(date +%Y%m%d)

# 升级
cd /opt/crater
docker compose pull
docker compose down
docker compose up -d

总结

Crater 是一款界面简洁、功能实用的发票管理系统，适合小型团队和个人使用。与功能更全面的 Invoice Ninja 相比，Crater 更加轻量且易于上手。购买搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受折扣。更多教程请访问搬瓦工VPS中文网。