2
0
mirror of https://github.com/acepanel/acepanel.github.io.git synced 2026-02-08 16:55:56 +08:00

feat: 更新文档

This commit is contained in:
2026-01-26 23:59:09 +08:00
parent 633801bfec
commit e90821394b
64 changed files with 3132 additions and 3132 deletions

View File

@@ -1,16 +1,16 @@
# Python 项目
# Python Project
Python 项目用于部署 DjangoFlaskFastAPI Python Web 应用。
Python projects are used to deploy Django, Flask, FastAPI, and other Python web applications.
## 前置要求
## Prerequisites
1. 安装 Python 运行环境:**应用** > **运行环境** > **Python**
2. 项目源代码
1. Install Python runtime: **Apps** > **Runtimes** > **Python**
2. Project source code
## 部署步骤
## Deployment Steps
1. 上传项目代码到服务器
2. 创建虚拟环境并安装依赖:
1. Upload project code to the server
2. Create virtual environment and install dependencies:
```bash
cd /opt/ace/project/myapp
@@ -19,50 +19,50 @@ source venv/bin/activate
pip install -r requirements.txt
```
3. 创建项目:
- **项目名**`myapp`
- **项目目录**`/opt/ace/project/myapp`
- **启动命令**:见下方示例
4. 开启 **反向代理**
3. Create project:
- **Project Name**: `myapp`
- **Project Directory**: `/opt/ace/project/myapp`
- **Startup Command**: See examples below
4. Enable **Reverse Proxy**
## 启动命令示例
## Startup Command Examples
### Django
```bash
# 开发服务器(不推荐生产使用)
# Development server (not recommended for production)
/opt/ace/project/myapp/venv/bin/python manage.py runserver 0.0.0.0:8000
# 使用 Gunicorn(推荐)
# Using Gunicorn (recommended)
/opt/ace/project/myapp/venv/bin/gunicorn myproject.wsgi:application -b 0.0.0.0:8000 -w 4
# 使用 uWSGI
# Using uWSGI
/opt/ace/project/myapp/venv/bin/uwsgi --http 0.0.0.0:8000 --module myproject.wsgi
```
### Flask
```bash
# 开发服务器(不推荐生产使用)
# Development server (not recommended for production)
/opt/ace/project/myapp/venv/bin/python app.py
# 使用 Gunicorn(推荐)
# Using Gunicorn (recommended)
/opt/ace/project/myapp/venv/bin/gunicorn app:app -b 0.0.0.0:8000 -w 4
```
### FastAPI
```bash
# 使用 Uvicorn
# Using Uvicorn
/opt/ace/project/myapp/venv/bin/uvicorn main:app --host 0.0.0.0 --port 8000
# 使用 Gunicorn + Uvicorn Workers(推荐)
# Using Gunicorn + Uvicorn Workers (recommended)
/opt/ace/project/myapp/venv/bin/gunicorn main:app -b 0.0.0.0:8000 -w 4 -k uvicorn.workers.UvicornWorker
```
## 常用框架配置
## Common Framework Configurations
### Django 生产配置
### Django Production Configuration
`settings.py`:
@@ -72,13 +72,13 @@ ALLOWED_HOSTS = ['your-domain.com']
STATIC_ROOT = '/opt/ace/project/myapp/static/'
```
收集静态文件:
Collect static files:
```bash
/opt/ace/project/myapp/venv/bin/python manage.py collectstatic
```
### FastAPI 示例
### FastAPI Example
```python
from fastapi import FastAPI
@@ -90,47 +90,47 @@ def read_root():
return {"Hello": "World"}
```
## Gunicorn 配置
## Gunicorn Configuration
创建 `gunicorn.conf.py`
Create `gunicorn.conf.py`:
```python
bind = "0.0.0.0:8000"
workers = 4
worker_class = "sync" # "uvicorn.workers.UvicornWorker" for FastAPI
worker_class = "sync" # Or "uvicorn.workers.UvicornWorker" for FastAPI
timeout = 30
keepalive = 2
```
启动命令:
Startup command:
```bash
/opt/ace/project/myapp/venv/bin/gunicorn -c gunicorn.conf.py myproject.wsgi:application
```
## 虚拟环境
## Virtual Environment
强烈建议使用虚拟环境隔离项目依赖:
It is strongly recommended to use virtual environments to isolate project dependencies:
```bash
# 创建虚拟环境
# Create virtual environment
python3.13 -m venv venv
# 激活虚拟环境
# Activate virtual environment
source venv/bin/activate
# 安装依赖
# Install dependencies
pip install -r requirements.txt
# 退出虚拟环境
# Deactivate virtual environment
deactivate
```
## 常见问题
## Common Issues
### 依赖安装失败
### Dependency Installation Failed
某些包需要编译,确保安装了必要的系统依赖:
Some packages require compilation, ensure necessary system dependencies are installed:
```bash
# AlmaLinux/Rocky Linux
@@ -140,10 +140,10 @@ yum install gcc python3-devel
apt install gcc python3-dev
```
### 静态文件 404
### Static Files 404
Django 生产环境需要配置 Nginx 直接提供静态文件,或使用 WhiteNoise
Django production environment needs to configure Nginx to serve static files directly, or use WhiteNoise.
### 数据库连接问题
### Database Connection Issues
检查数据库配置和网络连接,确保数据库服务正常运行。
Check database configuration and network connection, ensure the database service is running properly.