English

简体中文
繁體中文

English

简体中文
繁體中文

Appearance

Python Project ​

Python projects are used to deploy Django, Flask, FastAPI, and other Python web applications.

Prerequisites ​

  1. Install Python runtime: Apps > Runtimes > Python
  2. Project source code

Deployment Steps ​

  1. Upload project code to the server
  2. Create virtual environment and install dependencies:
bash
cd /opt/ace/project/myapp
python3.13 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  1. Create project:
    • Project Name: myapp
    • Project Directory: /opt/ace/project/myapp
    • Startup Command: See examples below
  2. 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

# Using Gunicorn (recommended)
/opt/ace/project/myapp/venv/bin/gunicorn myproject.wsgi:application -b 0.0.0.0:8000 -w 4

# 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

# Using Gunicorn (recommended)
/opt/ace/project/myapp/venv/bin/gunicorn app:app -b 0.0.0.0:8000 -w 4

FastAPI ​

bash
# Using Uvicorn
/opt/ace/project/myapp/venv/bin/uvicorn main:app --host 0.0.0.0 --port 8000

# 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 Production Configuration ​

settings.py:

python
DEBUG = False
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 Example ​

python
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

Gunicorn Configuration ​

Create gunicorn.conf.py:

python
bind = "0.0.0.0:8000"
workers = 4
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
yum install gcc python3-devel

# Ubuntu/Debian
apt install gcc python3-dev

Static Files 404 ​

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.