document/content/docs/introduction/guide/dashboard/workflow/sandbox-v2.mdx
本文档适用于 FastGPT 4.14.8 及以上版本。4.14.7 及以下版本请参考 代码运行(弃)。
代码运行节点支持在安全沙盒中执行 JavaScript 和 Python 代码,用于数据处理、格式转换、逻辑计算等场景。
支持的语言
注意事项
fastgpt-sandbox 镜像,并配置 CODE_SANDBOX_URL 环境变量。可在自定义输入中添加代码运行需要的变量。
JavaScript — 在 main 函数参数中解构:
async function main({data1, data2}){
return {
result: data1 + data2
}
}
Python — 在 main 函数参数中按变量名接收, 节点里输入的变量名一定要与main中的变量名一致,顺序可以任意:
def main(data1, data2):
return {"result": data1 + data2}
务必返回一个 object 对象(JS)或 dict 字典(Python)。
自定义输出中,可以添加变量名来获取对应 key 下的值。例如返回了:
{
"result": "hello",
"count": 42
}
自定义输出中添加 result 和 count 两个变量即可获取对应的值。
在沙盒内发起外部 HTTP 请求。自动拦截内网地址(SSRF 防护)。
JavaScript 示例:
async function main({url}){
const res = await SystemHelper.httpRequest(url, {
method: 'GET', // 请求方法,默认 GET
headers: {}, // 自定义请求头
body: null, // 请求体(对象会自动 JSON 序列化)
timeout: 60 // 超时秒数,最大 60s
})
return {
status: res.status,
data: res.data
}
}
Python 示例:
def main(url):
res = SystemHelper.httpRequest(url, method="GET", headers={}, timeout=10)
return {"status": res["status"], "data": res["data"]}
限制:
以下 npm 模块可通过 require() 使用:
| 模块 | 说明 | 示例 |
|---|---|---|
lodash | 工具函数库 | const _ = require('lodash') |
moment | 日期处理 | const moment = require('moment') |
dayjs | 轻量日期库 | const dayjs = require('dayjs') |
crypto-js | 加密库 | const CryptoJS = require('crypto-js') |
uuid | UUID 生成 | const { v4 } = require('uuid') |
qs | 查询字符串解析 | const qs = require('qs') |
其他模块(如 fs, child_process, net 等)被禁止使用。
以下 Python 标准库和第三方库可直接 import:
数学和数值计算
| 模块 | 说明 |
|---|---|
math | 数学函数 |
cmath | 复数数学 |
decimal | 十进制浮点运算 |
fractions | 分数运算 |
random | 随机数生成 |
statistics | 统计函数 |
数据结构和算法
| 模块 | 说明 |
|---|---|
collections | 容器数据类型 |
array | 数组 |
heapq | 堆队列 |
bisect | 数组二分查找 |
queue | 队列 |
copy | 浅拷贝和深拷贝 |
函数式编程
| 模块 | 说明 |
|---|---|
itertools | 迭代器工具 |
functools | 高阶函数 |
operator | 标准运算符 |
字符串和文本处理
| 模块 | 说明 |
|---|---|
string | 字符串常量 |
re | 正则表达式 |
difflib | 差异计算 |
textwrap | 文本包装 |
unicodedata | Unicode 数据库 |
codecs | 编解码器 |
日期和时间
| 模块 | 说明 |
|---|---|
datetime | 日期时间 |
time | 时间访问 |
calendar | 日历 |
数据序列化
| 模块 | 说明 |
|---|---|
json | JSON 编解码 |
csv | CSV 文件读写 |
base64 | Base64 编解码 |
binascii | 二进制和 ASCII 转换 |
struct | 字节串解析 |
加密和哈希
| 模块 | 说明 |
|---|---|
hashlib | 哈希算法 |
hmac | HMAC 消息认证 |
secrets | 安全随机数 |
uuid | UUID 生成 |
类型和抽象
| 模块 | 说明 |
|---|---|
typing | 类型提示 |
abc | 抽象基类 |
enum | 枚举类型 |
dataclasses | 数据类 |
contextlib | 上下文管理器 |
其他实用工具
| 模块 | 说明 |
|---|---|
pprint | 美化打印 |
weakref | 弱引用 |
第三方库
| 模块 | 说明 |
|---|---|
numpy | 数值计算 |
pandas | 数据分析 |
matplotlib | 数据可视化 |
禁止使用的模块: os, sys, subprocess, socket, urllib, http, requests 等涉及系统调用、网络访问、文件系统的模块。
沙盒提供多层安全防护:
// 将逗号分隔的字符串转为数组
function main({input}){
const items = input.split(',').map(s => s.trim()).filter(Boolean)
return { items, count: items.length }
}
const dayjs = require('dayjs')
function main(){
const now = dayjs()
return {
today: now.format('YYYY-MM-DD'),
nextWeek: now.add(7, 'day').format('YYYY-MM-DD'),
timestamp: now.valueOf()
}
}
async function main({city}){
const res = await SystemHelper.httpRequest(
`https://api.example.com/weather?city=${city}`,
{ method: 'GET', timeout: 10 }
)
return {
temperature: res.data.temp,
weather: res.data.condition
}
}
const CryptoJS = require('crypto-js')
function main({text, key}){
const encrypted = CryptoJS.AES.encrypt(text, key).toString()
return { encrypted }
}
import math
def main(numbers):
if not numbers:
return {"error": "no data"}
mean = sum(numbers) / len(numbers)
variance = sum((x - mean)**2 for x in numbers) / len(numbers)
return {
"mean": mean,
"max": max(numbers),
"min": min(numbers),
"std": math.sqrt(variance)
}
from datetime import datetime, timedelta
def main(date_str):
dt = datetime.strptime(date_str, "%Y-%m-%d")
next_week = dt + timedelta(days=7)
return {
"input": date_str,
"next_week": next_week.strftime("%Y-%m-%d"),
"weekday": dt.strftime("%A")
}
def main(api_url, api_key):
res = SystemHelper.httpRequest(
api_url,
method="GET",
headers={"Authorization": f"Bearer {api_key}"},
timeout=10
)
return {
"status": res["status"],
"data": res["data"]
}
import json
def main(json_str):
data = json.loads(json_str)
# 提取特定字段
result = {
"names": [item["name"] for item in data if "name" in item],
"count": len(data)
}
return result
import re
def main(text):
# 提取所有邮箱地址
emails = re.findall(r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b', text)
return {
"emails": emails,
"count": len(emails)
}