最详细安装 PostgreSQL方法及常见问题解决
<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">一、在 Windows 系统上安装 PostgreSQL</a></li><ul class="second_class_ul"><li><a href="#_lab2_0_0">1. 下载 PostgreSQL 安装包</a></li><li><a href="#_lab2_0_1">2. 安装 PostgreSQL</a></li><li><a href="#_lab2_0_2">3. 验证 PostgreSQL 安装</a></li><li><a href="#_lab2_0_3">4. 配置 PostgreSQL 启动项</a></li></ul><li><a href="#_label1">二、在 Linux 系统上安装 PostgreSQL</a></li><ul class="second_class_ul"><li><a href="#_lab2_1_4">1. 安装 PostgreSQL</a></li><li><a href="#_lab2_1_5">2. 配置 PostgreSQL</a></li><li><a href="#_lab2_1_6">3. 设置 PostgreSQL</a></li><li><a href="#_lab2_1_7">4. 验证安装</a></li></ul><li><a href="#_label2">三、在 macOS 系统上安装 PostgreSQL</a></li><ul class="second_class_ul"><li><a href="#_lab2_2_8">3. 设置 PostgreSQL 超级用户密码</a></li><li><a href="#_lab2_2_9">4. 验证安装</a></li></ul><li><a href="#_label3">四、常见问题解决</a></li><ul class="second_class_ul"><li><a href="#_lab2_3_10">1. 无法连接到 PostgreSQL 数据库</a></li><li><a href="#_lab2_3_11">2. 无法通过 pgAdmin 连接</a></li></ul></ul></div><p class="maodian"><a name="_label0"></a></p><h2>一、在 Windows 系统上安装 PostgreSQL</h2><p class="maodian"><a name="_lab2_0_0"></a></p><h3>1. 下载 PostgreSQL 安装包</h3>
<ul><li>访问 PostgreSQL 官网下载页面：<a href="https://www.postgresql.org/download/windows/" rel="external nofollow" target="_blank">https://www.postgresql.org/download/windows/</a></li><li>选择 <strong>“Windows”</strong> 版本，点击下载并进入 EnterpriseDB 的安装页面。</li><li>下载最新版的安装包（.exe 文件）。</li></ul>
<p class="maodian"><a name="_lab2_0_1"></a></p><h3>2. 安装 PostgreSQL</h3>
<ul><li>双击下载的安装包（.exe 文件）。</li><li>在弹出的安装向导中，点击 Next 继续。</li><li>选择安装目录（默认安装路径为 C:\Program Files\PostgreSQL\xx，可以更改，但建议使用默认路径）。</li><li>选择安装的组件，默认情况下所有组件都会被勾选（包括 PostgreSQL Server、pgAdmin、Command Line Tools、StackBuilder）。一般保留默认设置即可，点击 Next。</li><li>设置数据库集群的 数据目录。这个目录会存放所有数据库的数据文件。你可以选择默认路径或自定义路径，点击 Next。</li><li>设置超级用户密码（即 postgres 用户的密码）。请记住这个密码，后面需要用到。</li><li>选择数据库端口（默认是 5432），一般不需要修改，点击 Next。</li><li>选择语言设置，通常选择 English 即可，点击 Next。</li><li>点击 Next，然后 Install 开始安装 PostgreSQL。</li><li>安装完成后，点击 Finish 完成安装。</li></ul>
<p class="maodian"><a name="_lab2_0_2"></a></p><h3>3. 验证 PostgreSQL 安装</h3>
<ul><li>在安装完成后，可以通过 pgAdmin（PostgreSQL 提供的图形界面工具）来连接数据库。</li><li>启动 pgAdmin，输入安装时设置的密码，连接到本地数据库。</li><li>你可以通过 SQL 查询工具 执行以下命令来验证数据库是否正常运行：</li></ul>
<div class="jb51code"><pre class="brush:sql;">SELECT version();</pre></div>
<p class="maodian"><a name="_lab2_0_3"></a></p><h3>4. 配置 PostgreSQL 启动项</h3>
<p>如果你希望 PostgreSQL 在 Windows 启动时自动启动，可以通过以下步骤配置：</p>
<ul><li>打开 <strong>服务管理器</strong>（按 <code>Win + R</code>，输入 <code>services.msc</code>）。</li><li>找到 PostgreSQL 服务（通常命名为 <code>postgresql-x64-xx</code>）。</li><li>右键点击，选择 <strong>属性</strong>。在 <strong>启动类型</strong> 中选择 <strong>自动</strong>，然后点击 <strong>应用</strong> 和 <strong>确定</strong>。</li></ul>
<p class="maodian"><a name="_label1"></a></p><h2>二、在 Linux 系统上安装 PostgreSQL</h2>
<p class="maodian"><a name="_lab2_1_4"></a></p><h3>1. 安装 PostgreSQL</h3>
<p>对于 Ubuntu/Debian 系统：</p>
<p>更新系统：</p>
<div class="jb51code"><pre class="brush:bash;">sudo apt update</pre></div>
<p>安装 PostgreSQL：</p>
<div class="jb51code"><pre class="brush:bash;">sudo apt install postgresql postgresql-contrib</pre></div>
<p>对于 CentOS/RHEL 系统： 更新系统：</p>
<div class="jb51code"><pre class="brush:bash;">sudo yum update</pre></div>
<p>安装 PostgreSQL：</p>
<div class="jb51code"><pre class="brush:bash;">sudo yum install postgresql-server postgresql-contrib</pre></div>
<p>初始化数据库：</p>
<div class="jb51code"><pre class="brush:bash;">sudo postgresql-setup initdb</pre></div>
<p>启动 PostgreSQL 服务：</p>
<div class="jb51code"><pre class="brush:bash;">sudo systemctl start postgresql</pre></div>
<p>设置 PostgreSQL 在开机时自动启动：</p>
<div class="jb51code"><pre class="brush:bash;">sudo systemctl enable postgresql</pre></div>
<p class="maodian"><a name="_lab2_1_5"></a></p><h3>2. 配置 PostgreSQL</h3>
<p>PostgreSQL 默认使用 <code>peer</code> 认证方式来允许操作系统用户登录。如果要使用密码认证，你需要修改 PostgreSQL 的配置文件：</p>
<div class="jb51code"><pre class="brush:bash;">sudo nano /var/lib/pgsql/data/pg_hba.conf</pre></div>
<p>找到如下行：</p>
<div class="jb51code"><pre class="brush:bash;">local all postgres peer</pre></div>
<p>将 <code>peer</code> 改为 <code>md5</code>，然后保存并退出。重启 PostgreSQL 服务以应用配置：</p>
<div class="jb51code"><pre class="brush:bash;">sudo systemctl restart postgresql</pre></div>
<p class="maodian"><a name="_lab2_1_6"></a></p><h3>3. 设置 PostgreSQL</h3>
<p>超级用户密码 切换到 PostgreSQL 用户：</p>
<div class="jb51code"><pre class="brush:bash;">sudo -i -u postgres</pre></div>
<p>进入 PostgreSQL 命令行界面：</p>
<div class="jb51code"><pre class="brush:bash;">psql</pre></div>
<p>设置 <code>postgres</code> 用户密码：</p>
<div class="jb51code"><pre class="brush:sql;">ALTER USER postgres WITH PASSWORD 'yourpassword';</pre></div>
<p>退出 PostgreSQL 命令行：</p>
<div class="jb51code"><pre class="brush:bash;">\q</pre></div>
<p class="maodian"><a name="_lab2_1_7"></a></p><p class="maodian"><a name="_lab2_2_9"></a></p><h3>4. 验证安装</h3>
<p>你可以使用以下命令来验证 PostgreSQL 是否安装成功并正常工作：</p>
<div class="jb51code"><pre class="brush:bash;">psql -U postgres -h localhost -d postgres</pre></div>
<p class="maodian"><a name="_label2"></a></p><h2>三、在 macOS 系统上安装 PostgreSQL</h2>
<p>1. 使用 Homebrew 安装 PostgreSQL 如果还没有安装 Homebrew，请先安装：</p>
<div class="jb51code"><pre class="brush:bash;">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</pre></div>
<p>安装 PostgreSQL：</p>
<div class="jb51code"><pre class="brush:bash;">brew install postgresql</pre></div>
<p>2. 启动 PostgreSQL 启动 PostgreSQL：</p>
<div class="jb51code"><pre class="brush:bash;">brew services start postgresql</pre></div>
<p>设置 PostgreSQL 在开机时自动启动：</p>
<div class="jb51code"><pre class="brush:bash;">brew services start postgresql</pre></div>
<p class="maodian"><a name="_lab2_2_8"></a></p><h3>3. 设置 PostgreSQL 超级用户密码</h3>
<p>切换到 PostgreSQL 用户：</p>
<div class="jb51code"><pre class="brush:bash;">psql postgres</pre></div>
<p>设置 <code>postgres</code> 用户密码：</p>
<div class="jb51code"><pre class="brush:sql;">ALTER USER postgres WITH PASSWORD 'yourpassword';</pre></div>
<p>退出 PostgreSQL 命令行：</p>
<div class="jb51code"><pre class="brush:bash;">\q</pre></div>
<h3>4. 验证安装</h3>
<p>你可以通过以下命令验证 PostgreSQL 是否安装成功并正常工作：</p>
<div class="jb51code"><pre class="brush:bash;">psql -U postgres -h localhost -d postgres</pre></div>
<p class="maodian"><a name="_label3"></a></p><h2>四、常见问题解决</h2>
<p class="maodian"><a name="_lab2_3_10"></a></p><h3>1. 无法连接到 PostgreSQL 数据库</h3>
<p>确认 PostgreSQL 服务是否正在运行：</p>
<div class="jb51code"><pre class="brush:bash;">sudo systemctl status postgresql</pre></div>
<p>确保防火墙没有阻止 PostgreSQL 默认端口（5432）。</p>
<p class="maodian"><a name="_lab2_3_11"></a></p><h3>2. 无法通过 pgAdmin 连接</h3>
<p>确保 <code>pg_hba.conf</code> 配置文件中已经设置为 <code>md5</code> 认证。检查 PostgreSQL 配置文件 <code>postgresql.conf</code> 中的 <code>listen_addresses</code> 是否设置为 <code>'*'</code>，即允许所有 IP 连接。</p>
頁:
[1]