部署/安装——Linux（Ubuntu）安装FVTT

最新发布：2026-05-18 首次发布：2026-05-18

前置要求

由于FVTT版本迭代，FVTT V13.X必须被安装在node.js 18.x以上的环境中才能正常运行，而node.js 18.x以上又刚需Ubuntu 20.x以上的Linux系统，虽然这个刚需可以被解决，但是要是从这里开始讲起的话也未免太麻烦了，因此请先确保自己的Ubuntu系统版本在20.x以上。

登录与远程

鉴于可能有小白是第一次接触Linux系统，因此从盘古开天地开始讲起。

首先在购入服务器之后，你会获得三个东西——用户名、密码、端口。

无论你是从哪个平台购买的服务器，它都一定会给你提供一个远程链接到服务器的功能，也可以是VNC。

在你远程到服务器上后，你的界面应该是这样的。

这代表着你的服务器在等待你登录。

先输入用户名root，随后回车，你会看到这样的字符。

此时你需要密码，然后你可能会发现，欸我输入密码怎么没有反应啊，输入不进去。

其实不是这样的，这里只是将你输入的内容隐藏了，你只需要输入密码然后回车就行，如果你的账号密码都正确，登录成功后你应该会得到这样的字符串。

可能略有不同，但一般都是以:~#结尾，并且此时你可以随意输入文本了，这就代表你成功登录了，之后你每次重启服务器之后在开机的时候都需要重复一次登录的操作才能进行服务器的管理。

服务器环境配置

确保自己是root用户，接下来我们开始安装FVTT所需要的前置环境，直接一行行复制粘贴回车即可，不需要额外操作

1、node.js

执行

curl -sL https://deb.nodesource.com/setup_24.x | sudo bash -

执行完毕后，如无报错，继续执行

sudo apt install -y nodejs

执行完毕后，输入nodejs -v，如果返回的结果类似如图所示，就代表安装成功了

2、libssl-dev

执行

sudo apt install -y libssl-dev

无报错即成功

3、unzip

执行

sudo apt install unzip

执行完毕后，输入unzip -v，如果返回的结果类似如图所示，就代表安装成功了

4、pm2

执行npm install -g pm2

无报错即成功

FVTT下载与安装

此步之前确认你已经购买了FVTT，来到下载页面，系统选择Linux，不要直接下载，点击旁边的TIMED URL，这会让你复制一个临时的下载链接

回到服务器，执行

mkdir foundryvtt

执行后没有反应是正常的，继续执行

mkdir foundrydata

执行后也会没有反应，随后我们执行

cd foundryvtt

此时，你的输入光标前面的字符串会变成这样

现在，执行下面的命令

wget -O foundryvtt.zip 你从下载页面复制的TIMED URL

此时，你的服务器就会开始下载FVTT压缩包，在下载完成之后，执行以下命令进行解压

unzip foundryvtt.zip

解压完毕后，输入ls，如果像这样有着各种杂七杂八的文件就代表解压基本没问题了

自此，FVTT就算安装完成了

FVTT的运行与PM2

要运行FVTT，你得对外开放一些端口，如果有各种安全考虑，那么请自行酌情开放，如果你完全不理解什么是端口，你也可以全部打开

你购买服务器的平台的管理页面一般会有类似于「安全组」「防火墙」这样的设置，打开它，新增策略，如果需要选择【出】或者【入】，那么请选择【入】，协议选择全部，端口范围如果你想全部打开那就直接输入1-65535，否便输入自己需要开放的端口，如果需要填写授权IP，就填写【0.0.0.0/0】

FVTT默认使用的端口号是30000

现在，我们可以开始运行你的FVTT了

执行以下命令

node resources/app/main.js --dataPath=$HOME/foundrydata

如果等待一段时间之后，你能看见（类似）以下信息，恭喜你，你运行成功了！

此时，通过在你的本地浏览器输入你的服务器IP地址:30000，你应该就能够进入FVTT的界面并进行配置了

但还没完，你还有最后一件事情要做，现在，回到你的服务器，键盘输入ctrl+c终止FVTT服务。

执行

pm2 start foundryvtt/resources/app/main.js

如果你能看见以下信息，恭喜你，你已经完成了安装的全部步骤！现在，继续研究FVTT怎么用吧（？）

此时，只要你的服务器不关闭，你随时都可以通过你的服务器IP地址:30000来进入FVTT，你还可以通过在FVTT的设置里将端口号从30000修改为80，来让你只需要输入服务器IP地址就能进入FVTT，不需要后面的端口号，但这就是可选项了。

如果之后你重启了服务器，需要重新启动FVTT，继续使用上面这条指令即可。

祝你使用愉快喵

附加项：Winscp

考虑到有一些资源你不能从FVTT本身的MOD下载里获取到，你需要从本地下载或者从群聊中下载再放到FVTT的Module中来进行安装——而

而大伙都觉得小白应该不知道如何将mod文件从本机上传到Linux服务器，所以有了这个附加条目

Winscp是一个非常方便的Linux远程图形化文件管理器，它是免费的，你可以从官网直接下载它

下载链接：https://winscp.net/eng/index.php（不要问我怎么下载噢）

使用教程：https://zhuanlan.zhihu.com/p/1949861979310265239

需要注意的是，链接配置中的端口需要输入你购入服务器的平台中给予你的那个端口号，即：

这个的端口，文件协议选择SFTP，链接成功后，就可以非常方便的从本机往Linux服务器上上传文件了

具体的Mod安装方法，请参考：

手动安装教程