开发学院

您的位置:首页>技术文章>正文

技术文章

suncae安装记录

开发学院2026-06-20 08:08:38
不低于ubuntu24.04 不然系统自带的glibc库版本太低导致无法运行项目,php版本不低于7.4(本教程采用php8.3),安装最新版的nginx。python3

系统要求

  1.不低于ubuntu24.04 不然系统自带的glibc库版本太低导致无法运行项目

  2.php版本不低于7.4(本教程采用php8.3),安装最新版的nginx。

  3.python3

安装PHP环境

  一条命令搞定

apt update && apt install -y  nginx php8.3-fpm php8.3 php8.3-cli  php8.3-common  php8.3-mysql php8.3-zip php8.3-gd php8.3-mbstring php8.3-curl php8.3-xml php8.3-bcmath php8.3-yaml

安装Python3

apt install -y python3 python3-pip python-is-python3 patchelf

安装依赖库

apt install -y libgomp1 inkscape libocct-foundation-dev libocct-data-exchange-dev occt-draw libopenmpi-dev liblapack-dev libblas-dev libxcursor-dev libxrender-dev libxi-dev libxrandr-dev libosmesa6 libglx-mesa0
apt install -y libopenmpi-dev liblapack-dev libblas-dev libxcursor-dev libxrender-dev libxi-dev libxrandr-dev libosmesa6 libglx-mesa0

  设置php最大执行时间 避免复杂任务超时

sed -i 's/^max_execution_time = .*/max_execution_time = 300/' /etc/php/8.3/fpm/php.ini
sed -i 's/^memory_limit = .*/memory_limit = 1024M/' /etc/php/8.3/fpm/php.ini
service php8.3-fpm restart

suncae 安装 

  一定要通过git clone 下载zip包在windows系统下会导致部分路径解压出问题,例子路径为/var/www/,下面网站相关操作都是基于这个路径

git clone https://github.com/seamplex/suncae.git

  clone成功之后,修改nginx默认网站路径或者新建网站,默认路径改称为/var/www/suncae/html,然后重新加载nginx配置文件

service nginx reload

  上一步结束后,进入/var/www/suncae所在目录,执行./deps.sh,由于国内deps.sh下载比较慢, 建议从别的地方拷贝压缩包/var/www/suncae/deps目录(deps默认无,需新建)中再执行deps.sh,或者开启科学上网,这个deps.sh下载中途会有概率直接断开,重新运行即可。

  部署完毕后,一定要检查目录权限,尤其关注下面几个路径。

chown -R www:www /var/www/suncae
#www为示例用户名和组名,你的系统不一定叫www,请根据实际情况修改

完整读写执行权限

chmod -R 755 /var/www/suncae

下面目录放开写入

chmod -R 777 /var/www/suncae/html/new
chmod -R 777 /var/www/suncae/data

  如果打开样式缺失或者模型无法预览,那么可能是网络原因导致几个css和js没有成功下载(下载后为0k),重新下载后解决。

  如果提交报错  下面是高频常见问题

  1.目录权限问题,重点检查上面的路径

  2.PHP 超时 / 内存太小,处理几何流程被强制杀死,调大php执行超时、内存大小。

  3.缺少 CAD / 网格处理依赖(除 gmsh/python 外的工具,如果前面都正常安装好依赖,一般不会有这个问题)

  4.PHP 执行 shell 命令被禁用(安全函数拦截,新安装系统一般很少,除非云服务器厂商默认会做一些安全配置),php.ini 禁用了exec/shell_exec/passthru,后台无法调用 gmsh/python 处理 STP

grep disable_functions /etc/php/8.0/fpm/php.ini