如何将Ktor项目部署至HostGator主机？

方案一：WAR包部署（适配HostGator Java共享主机） #

1. 配置Ktor项目支持WAR构建 #

修改项目的build.gradle.kts（Groovy项目则修改build.gradle），添加WAR插件及Servlet适配依赖：

plugins {
    application
    kotlin("jvm") version "1.9.20"
    war // 引入WAR构建插件
}

application {
    mainClass.set("io.ktor.server.netty.EngineMain")
}

tasks.war {
    archiveFileName.set("your-app-name.war")
    exclude("META-INF/*.kotlin_module") // 排除不必要的Kotlin模块文件
}

dependencies {
    implementation("io.ktor:ktor-server-servlet-jvm:2.3.7") // 替换为你的Ktor版本
    // 保留项目原有的Ktor核心、路由等依赖
}

2. 构建WAR包 #

在本地项目根目录执行构建命令：

• Linux/macOS：./gradlew war
• Windows：gradlew.bat war
  构建完成后，WAR包会生成在build/libs/目录下。

3. 上传并部署WAR包 #

• 登录HostGator的cPanel面板，打开文件管理器，进入public_html目录（或指定的子域名目录）。
• 上传生成的WAR包，HostGator的Java主机通常会自动将WAR包解压为同名目录；若未自动解压，可手动解压或联系客服开启该功能。
• 在cPanel中找到Java Servlets或Tomcat Manager，确认Tomcat版本为9+（适配Ktor 2.x），设置应用上下文路径（如/your-app-name）指向解压后的目录，最后重启Tomcat服务。

方案二：独立Jar包部署（需HostGator提供SSH权限，如VPS/高级虚拟主机） #

1. 构建可执行Jar包 #

修改build.gradle.kts配置可执行Jar：

plugins {
    application
    kotlin("jvm") version "1.9.20"
}

application {
    mainClass.set("io.ktor.server.netty.EngineMain")
}

tasks.jar {
    manifest {
        attributes["Main-Class"] = application.mainClass.get()
    }
    from(configurations.runtimeClasspath.get().map { if (it.isDirectory) it else zipTree(it) })
    archiveFileName.set("your-app-name.jar")
}

执行构建命令：./gradlew jar（Linux/macOS）或gradlew.bat jar（Windows），Jar包生成在build/libs/目录。

2. 上传Jar包到主机 #

• 通过SSH连接主机，使用scp命令上传：

  scp build/libs/your-app-name.jar your-username@your-hostgator-domain:/home/your-username/apps/
  

• 也可通过cPanel文件管理器上传至指定目录（如/home/your-username/apps/）。

3. 运行Jar包并配置自启动 #

• 登录SSH，进入Jar包所在目录，后台运行应用：

  java -jar your-app-name.jar &
  

• 配置systemd服务实现开机自启：
  1. 创建服务文件：sudo nano /etc/systemd/system/your-app.service
  2. 写入以下内容（替换占位符为实际信息）：

     [Unit]
     Description=Ktor Backend Application
     After=network.target
     
     [Service]
     User=your-username
     WorkingDirectory=/home/your-username/apps/
     ExecStart=/usr/bin/java -jar your-app-name.jar
     Restart=always
     
     [Install]
     WantedBy=multi-user.target
     

  3. 执行命令启用并启动服务：

     sudo systemctl daemon-reload
     sudo systemctl enable your-app.service
     sudo systemctl start your-app.service
     

4. 配置反向代理（可选） #

若需通过域名直接访问而非端口号，在cPanel中进入Apache Configuration -> Reverse Proxy，设置规则将域名请求转发至Ktor应用的运行端口（如localhost:8080）。

注意事项 #

• 确认HostGator套餐支持Java：登录cPanel查看是否有Java相关功能入口，或联系客服确认套餐是否包含Java运行环境，共享主机可能需要升级至支持Java的版本。
• 版本兼容性：Ktor 2.x要求Java 11+，需确保主机Java版本达标；Tomcat版本建议9+以适配Servlet 4.0+。
• 端口占用：使用独立Jar包时，避免占用主机已使用的端口（如80、443、8080），可在Ktor的application.conf中修改端口号。

内容的提问来源于stack exchange，提问作者Ginger McMurray