参考
环境变量
应用运行时环境变量参考
环境变量
应用启动时自动注入以下环境变量:
| 变量 | 适用 | 说明 |
|---|---|---|
PORT | GUI | 分配的端口号(如 4000) |
DATA_DIR | 全部 | 数据持久化目录 |
APP_DIR | 全部 | 应用代码目录 |
HOME | 全部 | 用户主目录(wc.workdir,如 /home/user-random-id) |
LANG | 全部 | 系统语言(zh-CN / en) |
JSOS_VERSION | 全部 | 系统版本号(取自根 package.json) |
PROXY_URL | 全部 | CORS 代理服务地址 |
PROXY_KEY | 全部 | CORS 代理 API Key(可选) |
PORT(仅 GUI 应用)
const port = process.env.PORT;
app.listen(port);不要硬编码端口号,始终使用 process.env.PORT。
DATA_DIR
应用专属数据目录。数据自动持久化,刷新后恢复。
import { writeFile, readFile } from 'fs/promises';
import { join } from 'path';
const dataFile = join(process.env.DATA_DIR, 'notes.json');
await writeFile(dataFile, JSON.stringify(notes));
const saved = JSON.parse(await readFile(dataFile, 'utf-8'));HOME
用户主目录,指向 wc.workdir(如 /home/user-random-id)。可用于存放用户配置文件或数据:
import { writeFile, readFile } from 'fs/promises';
import { join } from 'path';
// 用户配置文件目录
const configDir = join(process.env.HOME, '.myapp');
await writeFile(join(configDir, 'config.json'), JSON.stringify(config));注意: HOME 下的目录不会自动全部持久化。需要跨刷新保留的目录(如 ~/.pi)必须显式加入持久化列表:在 设置 → 持久化 页面添加,或使用 jsos persist add .pi。详见持久化目录管理。
LANG
根据系统语言设置,应用可据此决定显示语言:
const lang = process.env.LANG;
const greeting = lang.startsWith('zh') ? '你好' : 'Hello';JSOS_VERSION
系统版本号(取自根 package.json 的 version),可用于显示版本或做兼容判断:
const version = process.env.JSOS_VERSION; // 如 '2026.8.5'PROXY_URL / PROXY_KEY
CORS 代理配置,用于跨域请求:
const proxyUrl = process.env.PROXY_URL; // 如 'https://cors-proxy.jsos.dev'
const proxyKey = process.env.PROXY_KEY; // 如 'hello-world'(可选)
// 通过代理请求跨域接口
const response = await fetch(`${proxyUrl}/${targetUrl}`, {
headers: { 'x-cors-proxy-key': proxyKey }
});