Let's get moving: How to 安装 1panel on your Linux server

Honestly, figuring out how to 安装 1panel on your Linux server is probably the best move you'll make if you're tired of messy command-line management. If you've spent any time managing a VPS, you know the drill: configuring Nginx, setting up databases, and manually renewing SSL certificates can become a massive headache. 1panel is one of those tools that actually makes this stuff feel modern and, dare I say, almost fun.

I remember the first time I tried it; I was skeptical because I'd used plenty of other control panels before that felt like they were stuck in 2010. But 1panel is different. It's built on Go and uses Docker as its core engine, which is a total game-changer for keeping your environment clean. Let's walk through the process together so you can get it up and running without pulling your hair out.

Why even bother with 1panel?

Before we jump into the terminal, you might be wondering why you'd pick this over the "old guard" of server panels. For me, the biggest selling point is the Docker-based architecture. Most panels install things directly onto your OS, which eventually turns your server into a giant ball of dependency hell. With 1panel, everything stays in its own container. If you want to try a new version of PHP or MySQL, you just spin up a new container. It doesn't mess with your host system, and that's a huge win for stability.

The interface is also incredibly clean. It doesn't look like a cockpit from a 1970s airplane. It's snappy, supports dark mode (thank goodness), and the app store is actually useful. You can click a button and have a fully functioning WordPress site, a Redis instance, or even a local AI model running in minutes.

Getting your server ready

You can't just 安装 1panel on a toaster; you need a decent Linux environment. Ideally, you're looking at a fresh install of Ubuntu 20.04+, Debian 10+, or CentOS 7/8. Personally, I'm a big fan of Debian 12 for this kind of thing because it's rock-solid and stays out of your way.

As for hardware, don't try to run this on a server with 512MB of RAM. Since it relies heavily on Docker, you'll want at least 2GB of RAM if you plan on actually running apps like MySQL and Nginx. Sure, you can squeeze it onto 1GB, but the moment you start adding websites, your OOM (Out Of Memory) killer is going to have a field day.

Also, make sure you have root access. You'll be running commands that touch the core of the system, so if you're using a standard user, make sure you're in the sudoers list.

The actual command to 安装 1panel

Alright, let's get to the good stuff. One of the best things about modern open-source projects is the "one-click" installer. You don't have to download a dozen packages manually.

Open up your terminal—I usually use Termius or just the standard Mac/Linux terminal via SSH—and log into your server. Once you're in, you just need to run the official installation script.

For Ubuntu or Debian, you'll want to run this:

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

The script will start doing its thing immediately. It'll check your OS, download the necessary binaries, and set up the Docker environment if you don't have it already. It's pretty smart—it won't double-install Docker if it's already there, though I've found it's always cleaner to let the script handle the initial setup on a fresh machine.

Going through the interactive setup

While the script is running, it's not just going to leave you in the dark. It'll ask you a few questions to make sure the setup fits your needs.

First, it'll ask about the installation directory. Most people just hit Enter and stick with the default /opt/1panel. Unless you have a specific reason to move it (like a separate high-speed SSD mounted elsewhere), just go with the default.

Next, it'll ask you for a port. By default, it usually suggests something like 8089 or a random high-numbered port. I'd recommend changing this to something unique that you'll remember, but don't use standard ports like 80 or 443, as your web server will need those later.

Then comes the security stuff. You'll need to set an entrance code, a username, and a password. Don't skip the entrance code! This is an extra layer of security that acts like a secret path in your URL. So, instead of going to your-ip:8080, you'll go to your-ip:8080/your-secret-code. It stops bots from constantly banging on your login page.

Dealing with firewalls (The "It's not working!" part)

The most common reason people think they failed to 安装 1panel is that they can't access the web UI after the script finishes. 99% of the time, this is a firewall issue.

If you're using a cloud provider like AWS, Google Cloud, or DigitalOcean, you have to go into their web console and open the port you chose during installation. If you're using a local firewall like ufw on Ubuntu, you'll need to run:

sudo ufw allow 8089/tcp (Replace 8089 with your actual port).

Once that port is open, head over to your browser, type in your IP address followed by the port and that secret entrance code, and you should see the login screen. It's a pretty satisfying moment when that dashboard finally pops up.

What to do first inside the panel

Once you've successfully managed to 安装 1panel, don't just stare at the pretty graphs. There are a few things you should do right away to make your life easier.

  1. Check the App Store: This is the heart of 1panel. Go to the "App Store" tab and look for "OpenResty" (which is basically Nginx on steroids). You'll need this to host websites.
  2. Set up a Database: Grab MySQL or MariaDB from the app store. Since it's Dockerized, it'll ask you for a root password during the click-to-install process.
  3. Configure Backups: 1panel has built-in support for backing up to S3-compatible storage, Dropbox, or even just another local folder. Seriously, set this up now before you build something you care about.
  4. Explore the WAF: There's a built-in Web Application Firewall. It's surprisingly good at blocking common exploits and basic DDOS attempts.

Troubleshooting common hiccups

Sometimes things go sideways. If the installation script hangs, it's usually because of a slow connection to the resource servers. If you're located in a region with strict internet filtering, you might need to use a mirror or a proxy to get the Docker images to pull correctly.

Another thing I've noticed is that if you already have a web server like Apache or Nginx running on the host machine (not in Docker), 1panel might complain when you try to install OpenResty because the ports (80/443) are already taken. My advice? Kill the local services and let 1panel handle everything through Docker. It's much cleaner that way.

Wrapping it all up

The whole process to 安装 1panel usually takes less than five minutes if you have a fast internet connection. It's a refreshing take on server management that respects your time and your server's file system.

It's easy to get overwhelmed by all the options once you're inside, but just take it one step at a time. Start by hosting a simple static site, then move on to something more complex like a containerized Ghost blog or a Nextcloud instance. Once you get used to the Docker workflow that 1panel promotes, you'll find it very hard to go back to the old way of doing things. Happy hosting!