在 Debian 和 Ubuntu 上安装¶
硬件要求¶
Weblate 应该可以在任何现代硬件上正常运行，以下是在单个主机（Weblate、数据库和 Web 服务器）上运行 Weblate 所需的最低配置：
3 GB 的内存
2 个 CPU 核心
1 GB 的存储空间
备注
安装 Weblate 的实际要求会因其中管理的翻译规模而大不相同。
内存使用¶
内存越多越好——用于所有级别的缓存（文件系统，数据库和 Weblate）。如果有几百个翻译部件，那么推荐的最小内存为 4 GB。
提示
对于内存低于推荐值的系统，建议使用 单进程 Celery 设置。
CPU 用量¶
许多并发用户会增加所需的 CPU 内核数量。
存储使用¶
典型的数据库存储用量为大约 300 MB/每 100 万托管单词。
克隆的仓库变体必须有存储空间，但 Weblate 会试着通过影子克隆最小化存储空间的大小。
存储性能¶
Version control operations perform many filesystem metadata lookups. The
vcs subdirectory in DATA_DIR therefore needs low read
latency; storage with slow metadata access can make operations such as
git status take a long time even when its bulk throughput is good.
Keep CACHE_DIR on low-latency local or temporary storage when
possible.
The deployment checks measure metadata lookup latency for both locations and warn when the median latency exceeds 10 milliseconds. This is an approximate point-in-time measurement affected by filesystem and system load. Rerun weblate check --deploy before changing the storage configuration.
节点¶
对中小站点（几百万托管单词），所有的 Weblate 部件（见 架构概览）可以运行在单个节点上。
当托管单词数增长到数以亿计时，推荐使用专门的数据库节点（见 Weblate 的数据库设置）。
安装¶
系统要求¶
安装构建 Python 模块所需的依赖项（请参见 软件要求）：
apt install -y \
libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
libffi-dev \
libacl1-dev liblz4-dev libzstd-dev libxxhash-dev libssl-dev libpq-dev libjpeg-dev build-essential \
python3-gdbm python3-dev git
根据您打算使用的功能来安装所需的可选依赖项（参见 Python 依赖项）：
apt install -y \
libldap2-dev libldap-common libsasl2-dev \
libxmlsec1-dev
可选地安装生产服务器运行所需要的软件，参见 运行服务器、Weblate 的数据库设置、使用 Celery 的后台任务。根据于您的安装所占的空间，您会想要在特定的服务器上运行这些部件。
本地安装的使用说明：
# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3
# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3
# Caching backend: Valkey
apt install -y valkey-server
# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib
# SMTP server
apt install -y exim4
# Gettext tools for gettext POT/PO update add-ons
apt install -y gettext
uv 包管理器¶
提示
我们在用 uv 包管理器安装 Weblate。
curl -LsSf https://astral.sh/uv/install.sh | sh
参见
Python 模块¶
提示
我们将 Weblate 安装在一个独立的 Python 环境中。
为 Weblate 创建 Python 环境：
uv venv ~/weblate-env
为 Weblate 激活 Python 环境：
. ~/weblate-env/bin/activate安装包含所有可选依赖项的 Weblate：
# Install Weblate with all optional dependencies uv pip install "weblate[all]"
请查看 Python 依赖项 以了解对可选依赖关系的微调情况。
配置 Weblate¶
备注
以下内容假设 Weblate 使用的 Python 环境已经激活（可以通过 . ~/weblate-env/bin/activate 来实现）。如果没有，请指定 weblate 命令的完整路径为 ~/weblate-env/bin/weblate。
将文件
~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py复制为~/weblate-env/lib/python3.9/site-packages/weblate/settings.py。将新的
settings.py文件中的值调整为您所需要的。您至少需要提供数据库凭证和 Django 密钥，但在生产安装中需要做更多的更改，参见：调整配置。为 Weblate 新建数据库及其结构（示例中的设置使用 PostgreSQL，已经准备好的生产设置请查看 Weblate 的数据库设置）：
weblate migrate参见
创建管理员用户账户
admin，生成账户密码并将密码复制到剪贴板；记得保存密码供日后使用：weblate createadmin提示
如果你之前丢失了 admin 密码，可以使用以下命令生成一个新的 admin 密码：
weblate createadmin --update
参见
为你的收集 Web 服务器用的静态文件（请参见 运行服务器 和 为静态文件提供服务）：
weblate collectstatic启动 Celery 工作进程。这对开发来说是不必要的，但强烈建议在其他场景这样做。更多信息请参见 使用 Celery 的后台任务：
celery --app=weblate.utils worker --beat \ --queues=celery,notify,memory,translate,backup \ --prefetch-multiplier=1
启动开发服务器（运行服务器 详细说明生产设置）：
weblate runserver
安装后¶
配置，您的 Weblate 服务器现在运行了，您可以使用它来启动。
您可以在
http://localhost:8000/访问 Weblate。使用安装期间获得的管理凭证登录或注册新用户。
现在，您可以在 Weblate Python 环境活动时使用 weblate 命令来运行 Weblate 命令，见 管理命令。
要停止测试用服务器，你可以按下 Ctrl+C。
要检查你安装的潜在问题，有两个途径。一是
/manage/performance/URL (参见 性能报告)，二是使用 weblate check --deploy，参见 生产设置。
添加翻译¶
打开管理界面（
http://localhost:8000/create/project/），并新建您想要翻译的项目。更多细节请参见 项目配置。这里所有需要您指定的只是项目名称及其网站。
新建一个部件，该部件是要翻译的实际对象——它指向版本控制系统仓库，并选择要翻译的文件。更多详细信息请参见 部件配置。
此处的重要字段为：部件名称、源代码仓库 及用于寻找可翻译文件的 文件掩码。Weblate 支持多种格式，包括 GNU gettext PO (Portable Object)、Android 字符串资源、苹果 iOS 字符串、Java 属性、Stringsdict 格式 或 Fluent 格式，更多细节见 本地化文件格式。
一旦完成上面的工作（根据您 VCS 仓库的大小，以及需要翻译的信息数量，这可能是个漫长的过程），您就可以开始翻译了。