GreaterWMS 部署教程：从环境准备到系统验证的完整指南

一、引言：为什么选择GreaterWMS？

GreaterWMS是一款基于Python Django框架开发的开源仓储管理系统（WMS），支持多仓库、多货主、批次管理、波次拣货等核心功能，适用于电商、制造业、第三方物流等场景。其模块化设计、RESTful API接口和移动端支持（PDA/Android）使其成为企业数字化转型的高性价比选择。本文将详细介绍从环境搭建到系统上线的完整部署流程，帮助开发者快速掌握部署技巧。

二、部署前环境准备

1. 服务器硬件要求

• 基础配置：2核CPU、4GB内存、50GB磁盘空间（适用于测试环境）
• 生产环境建议：4核CPU、8GB内存、200GB磁盘空间（支持高并发）
• 网络要求：固定公网IP（若需外网访问）、开放80/443端口（HTTP/HTTPS）

2. 操作系统选择

• 推荐系统：Ubuntu 22.04 LTS（兼容性最佳）
• 替代方案：CentOS 8、Debian 11
• 关键操作：更新系统包 sudo apt update && sudo apt upgrade -y

3. 依赖软件安装

# 安装Python 3.9+
sudo apt install python3.9 python3.9-venv python3.9-dev
# 安装数据库（PostgreSQL示例）
sudo apt install postgresql postgresql-contrib
# 安装Redis（用于缓存和任务队列）
sudo apt install redis-server
# 安装Nginx和Supervisor
sudo apt install nginx supervisor

三、数据库配置与初始化

1. PostgreSQL设置

-- 创建数据库用户和权限
CREATE USER greaterwms WITH PASSWORD 'your_secure_password';
CREATE DATABASE greaterwms_db OWNER greaterwms;
ALTER DATABASE greaterwms_db SET TIMEZONE TO 'Asia/Shanghai';

2. 数据库迁移与初始化

# 克隆代码库
git clone https://github.com/singledog/greaterwms.git
cd greaterwms
# 创建虚拟环境并激活
python3.9 -m venv venv
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 修改数据库配置（config/settings.py）
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'greaterwms_db',
        'USER': 'greaterwms',
        'PASSWORD': 'your_secure_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}
# 执行数据库迁移
python manage.py migrate

四、系统核心配置

1. 基础设置文件

修改config/settings.py中的关键参数：

# 时区设置
TIME_ZONE = 'Asia/Shanghai'
# 安全配置
ALLOWED_HOSTS = ['your_server_ip', 'domain.com']
SECURE_SSL_REDIRECT = True  # 生产环境启用
# 静态文件配置
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

2. 超级用户创建

python manage.py createsuperuser
# 输入用户名、邮箱和密码

3. 初始数据导入（可选）

# 导入示例仓库数据
python manage.py loaddata initial_data.json

五、生产环境部署方案

1. Gunicorn + Nginx配置

Gunicorn启动命令：

gunicorn config.wsgi:application \
  --bind 0.0.0.0:8000 \
  --workers 4 \
  --worker-class gevent \
  --timeout 120

Nginx配置示例：

server {
    listen 80;
    server_name domain.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name domain.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    location /static/ {
        alias /path/to/greaterwms/staticfiles/;
    }
}

2. Supervisor进程管理

创建/etc/supervisor/conf.d/greaterwms.conf：

[program:greaterwms]
command=/path/to/venv/bin/gunicorn config.wsgi:application --bind 0.0.0.0:8000 --workers 4
directory=/path/to/greaterwms
user=www-data
autostart=true
autorestart=true
stderr_logfile=/var/log/greaterwms.err.log
stdout_logfile=/var/log/greaterwms.out.log

启动服务：

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start greaterwms

六、系统验证与测试

1. 功能测试清单

• 基础功能：

  • 登录系统（默认账号：admin/密码）
  • 创建仓库、货主、商品信息
  • 执行入库单（Purchase Order）和出库单（Sales Order）

• 高级功能：

  • 波次拣货（Wave Picking）策略验证
  • 批次管理（Expiration Date Tracking）
  • PDA设备扫码测试（需配置移动端）

2. 性能测试建议

• 使用Locust进行压力测试：
  ```python
  from locust import HttpUser, task

class WarehouseUser(HttpUser):
@task
def load_test(self):
self.client.get(“/api/inventory/“)
self.client.post(“/api/order/“, json={“sku”: “TEST001”, “qty”: 10})

- 监控指标：
  - 响应时间（<500ms）
  - 数据库查询效率（使用Django Debug Toolbar）
  - 服务器资源占用率（CPU/内存）
## 七、常见问题解决方案
### 1. 数据库连接错误
- **现象**：`django.db.utils.OperationalError`
- **解决**：
  - 检查`settings.py`中的数据库配置
  - 验证PostgreSQL服务是否运行：`sudo systemctl status postgresql`
  - 检查防火墙设置：`sudo ufw allow 5432/tcp`
### 2. 静态文件加载失败
- **现象**：404错误或CSS/JS未加载
- **解决**：
  - 执行`python manage.py collectstatic`
  - 检查Nginx配置中的`alias`路径是否正确
  - 清除浏览器缓存
### 3. 移动端集成问题
- **PDA设备配置**：
  - 安装APK包（需从Release页面下载）
  - 配置服务器地址：`设置 > 服务器配置 > 输入域名`
  - 测试扫码功能：使用预置的测试条码（如`SKU001`）
## 八、升级与维护策略
### 1. 版本升级流程
```bash
# 备份数据库
pg_dump -U greaterwms greaterwms_db > backup.sql
# 拉取最新代码
git pull origin main
# 安装新依赖
pip install -r requirements.txt
# 执行数据库迁移
python manage.py migrate
# 重启服务
sudo supervisorctl restart greaterwms

2. 定期维护任务

• 每周：
  • 清理过期会话：python manage.py clearsessions
  • 备份日志文件
• 每月：
  • 执行数据库优化：VACUUM FULL ANALYZE（PostgreSQL）
  • 检查依赖库更新：pip list --outdated

九、扩展功能建议

1. 第三方系统集成

• ERP对接：通过REST API同步订单数据
• 物流平台：使用Celery异步任务对接快递鸟API
• 数据分析：连接Metabase或Superset进行可视化

2. 自定义开发指南

• 模块扩展：
  • 创建apps/custom_module目录
  • 在config/settings.py中注册应用
  • 编写Model/View/Template
• API扩展：
  ```python

  apps/api/views.py

  from rest_framework.decorators import api_view
  from rest_framework.response import Response

@api_view([‘GET’])
def custom_endpoint(request):
return Response({“message”: “Custom API Endpoint”})
```

十、总结与资源推荐

1. 部署关键点回顾

• 严格遵循环境依赖要求
• 重视数据库配置优化
• 采用进程管理工具保障稳定性
• 实施完整的测试验证流程

2. 进阶学习资源

• 官方文档：GreaterWMS GitHub Wiki
• 社区支持：Gitter聊天室、Django中文论坛
• 类似项目：Odoo WMS模块、ERPNext仓储管理

通过本文的详细指导，开发者可以完成从环境搭建到系统上线的完整部署流程。实际部署中建议先在测试环境验证所有功能，再逐步迁移到生产环境。对于企业用户，可考虑结合Docker容器化部署以提升环境一致性，或通过Kubernetes实现高可用集群。