funcomputer

Google Colab / 云端开发环境的个人一次性配置脚本集合：挂载 Google Drive、恢复 SSH 和 Git 配置、安装并启动 code-server（网页版 VSCode）、通过 natapp 做内网穿透、拉取 fun 系列仓库到 workspace。代码里硬编码了大量个人路径（如 /content/gdrive/My Drive/core/configs/）和 Git 账号邮箱，本质是作者自用的 Colab 环境初始化脚本，没有做通用化封装，也没有 CLI 入口，目前不在维护中。code-server / natapp 这两个后台常驻进程通过 scripts/setup.sh 统一管理生命周期，PID 与日志落在仓库的 .run/ 目录下。

该包未发布到 PyPI，只能从源码安装：

git clone git@github.com:farfarfun/funcomputer.git
cd funcomputer
pip install -e .

结构

• funcomputer/run/__init__.py：run_cmd(cmd)，执行 shell 命令（传 list 时依次执行，遇到失败即抛出 RuntimeError）
• funcomputer/config/core.py：config_all() / config_ssh()，从 Google Drive 恢复 SSH key
• funcomputer/install/config.py：config_all() / config_init() / config_ssh() / config_git() / config_workspace()，从 Google Drive 恢复 SSH key、配置 git 用户名邮箱，并把 funtool、funkeras、fundrive、funcomputer 克隆到 /root/workspace
• funcomputer/install/core_server.py：install_drive() 挂载 Google Drive；install_code_server() 安装 code-server 并装一批 VSCode 插件；start_code_server() / start_natapp() 前台执行启动 code-server / natapp 内网穿透的命令本身（不做后台化）
• funcomputer/workspace/core.py：init()，创建 /root/workspace 并克隆 fun 系列仓库
• scripts/setup.sh：code-server / natapp 的统一生命周期管理入口（start/stop/restart/run/status，区分 dev/prod），负责后台化、PID 文件与日志重定向，运行时文件落在 .run/ 下

用法示例

from funcomputer.install.core_server import install_drive, install_code_server
from funcomputer.install.config import config_all

install_drive()        # 挂载 Google Drive（需在 Colab 环境中运行）
config_all()           # 从 Drive 恢复 ssh/git 配置，克隆 fun 系列仓库
install_code_server()  # 安装 code-server 及常用插件

安装完成后，通过 scripts/setup.sh 启动/停止 code-server（需先设置 CODE_SERVER_PASSWORD 环境变量）：

export CODE_SERVER_PASSWORD=xxx
./scripts/setup.sh start code-server dev
./scripts/setup.sh status code-server
./scripts/setup.sh stop code-server

natapp 同理，需要先设置 NATAPP_AUTH_TOKEN 环境变量：

export NATAPP_AUTH_TOKEN=xxx
./scripts/setup.sh start natapp dev

说明

代码中的路径（/content/gdrive/...）和 Git 账号邮箱（funcomputer/install/config.py 的 config_git()）是写死的个人配置，直接搬到其他环境大概率跑不通，需要按自己的情况修改。natapp token 和 code-server 密码并未硬编码：start_natapp() 从显式参数或 NATAPP_AUTH_TOKEN 环境变量读取，start_code_server() 要求通过 CODE_SERVER_PASSWORD 环境变量提供密码，缺失时会直接抛出异常拒绝启动。项目只有 tests/test_smoke.py 一个导入冒烟测试，没有对外发布，属于一次性的个人工具脚本。

---

关于 farfarfun

farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

• 🏠 组织主页：https://github.com/farfarfun
• 📦 PyPI：https://pypi.org/user/niuliangtao/
• 📧 联系：farfarfun@qq.com

本项目基于 MIT 协议开源。