从安装到上线：WebVella-ERP在Linux环境下的完整部署流程

【免费下载链接】WebVella-ERP Free and open-source pluggable ERP and CRM software based on ASP.NET Core 5, RazorPages and PostgreSQL . Targets Linux or Windows as host OS. 项目地址: https://gitcode.com/gh_mirrors/we/WebVella-ERP

WebVella-ERP是一款基于ASP.NET Core 9和PostgreSQL 16的免费开源ERP和CRM软件，支持Linux或Windows系统部署。本文将详细介绍如何在Linux环境下从源码到上线的完整部署流程，帮助新手用户快速搭建属于自己的企业资源管理系统。

📋 准备工作：环境依赖安装

在开始部署前，请确保您的Linux系统已安装以下必要组件：

1. .NET Core 9 SDK及运行时
   WebVella-ERP基于ASP.NET Core 9开发，需通过官方渠道安装对应版本的SDK和运行时环境。

2. PostgreSQL 16数据库
   作为WebVella-ERP的默认数据库，建议安装PostgreSQL 16及以上版本，并配置好数据库用户和权限。可通过系统包管理器或官方源安装：

   sudo apt-get update
   sudo apt-get install postgresql-16 postgresql-contrib
   

3. Git工具
   用于克隆项目源码：

   sudo apt-get install git
   

🚀 第一步：获取项目源码

通过Git克隆WebVella-ERP仓库到本地：

git clone https://gitcode.com/gh_mirrors/we/WebVella-ERP
cd WebVella-ERP

🛠️ 第二步：数据库配置

1. 创建数据库
   使用pgAdmin或命令行创建空数据库（例如webvella_erp）：

   sudo -u postgres psql
   CREATE DATABASE webvella_erp;
   CREATE USER erp_user WITH ENCRYPTED PASSWORD 'your_secure_password';
   GRANT ALL PRIVILEGES ON DATABASE webvella_erp TO erp_user;
   \q
   

2. 修改配置文件
   编辑WebVella.Erp.Site目录下的Config.json文件，更新数据库连接字符串：

   "ConnectionString": "Server=localhost;Port=5432;User Id=erp_user;Password=your_secure_password;Database=webvella_erp;Pooling=true;"
   

   可根据需要调整时区（TimeZoneName）、开发模式（DevelopmentMode）等参数。

🔨 第三步：构建与发布应用

1. 编译项目
   使用dotnet命令构建解决方案：

   dotnet build WebVella.ERP3.sln
   

2. 发布应用
   将WebVella.Erp.Site项目发布到指定目录（例如/var/www/webvella-erp）：

   dotnet publish WebVella.Erp.Site/WebVella.Erp.Site.csproj -o /var/www/webvella-erp --configuration Release
   

📝 第四步：应用初始化与验证

1. 首次运行
   执行发布目录下的可执行文件，系统将自动初始化数据库结构和默认数据：

   cd /var/www/webvella-erp
   dotnet WebVella.Erp.Site.dll
   

2. 访问系统
   打开浏览器访问http://localhost:5000，使用默认账号登录：

   • 邮箱：erp@webvella.com
   • 密码：erp

3. 创建应用与实体
   登录后，通过SDK插件创建自定义应用和业务实体。例如，创建一个新应用：

创建实体时可配置字段、权限等信息：

🌐 第五步：配置Web服务器（Nginx）

为实现生产环境部署，建议使用Nginx作为反向代理：

1. 安装Nginx

   sudo apt-get install nginx
   

2. 配置站点
   创建Nginx配置文件/etc/nginx/sites-available/webvella-erp：

   server {
       listen 80;
       server_name your_domain.com;
   
       location / {
           proxy_pass http://localhost:5000;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection keep-alive;
           proxy_set_header Host $host;
           proxy_cache_bypass $http_upgrade;
       }
   }
   

3. 启用站点并重启Nginx

   sudo ln -s /etc/nginx/sites-available/webvella-erp /etc/nginx/sites-enabled/
   sudo nginx -t
   sudo systemctl restart nginx
   

⚙️ 第六步：设置系统服务（Systemd）

为确保应用开机自启，创建Systemd服务文件/etc/systemd/system/webvella-erp.service：

[Unit]
Description=WebVella ERP Service
After=network.target postgresql.service

[Service]
WorkingDirectory=/var/www/webvella-erp
ExecStart=/usr/bin/dotnet WebVella.Erp.Site.dll
Restart=always
RestartSec=10
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl enable webvella-erp
sudo systemctl start webvella-erp

🎨 第七步：自定义页面与插件

WebVella-ERP支持通过SDK插件扩展功能。例如，创建自定义页面：

可通过WebVella.Erp.Plugins.SDK目录下的工具管理实体、页面和数据源，详细文档请参考docs/developer/目录。

📌 部署注意事项

• 安全配置：生产环境中需修改默认密码、设置HTTPS（通过Let's Encrypt获取免费证书）。
• 性能优化：调整PostgreSQL连接池参数，启用Nginx缓存静态资源。
• 日志管理：通过WebVella.Erp.Web/Utils/Log.cs配置日志输出路径。
• 插件开发：参考WebVella.Erp.Plugins.Project示例开发业务插件。

通过以上步骤，您已成功在Linux环境下部署WebVella-ERP。如需进一步定制，可查阅官方开发文档或社区资源。

【免费下载链接】WebVella-ERP Free and open-source pluggable ERP and CRM software based on ASP.NET Core 5, RazorPages and PostgreSQL . Targets Linux or Windows as host OS. 项目地址: https://gitcode.com/gh_mirrors/we/WebVella-ERP