JSOS
参考

环境变量

应用运行时环境变量参考

环境变量

应用启动时自动注入以下环境变量:

变量适用说明
PORTGUI分配的端口号(如 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 }
});

On this page